Retry a Post

Retry to publish a post that failed

PUT /post/retry

cURL

curl \
-H "Authorization: Bearer API_KEY" \
-H 'Content-Type: application/json' \
-d '{"id": "s8k2jsk0pl"}' \
-X PUT https://api.ayrshare.com/api/post/retry

const API_KEY = "API_KEY";

fetch("https://api.ayrshare.com/api/post/retry", {
  method: "PUT",
  headers: {
    "Content-Type": "application/json",
    Authorization: `Bearer ${API_KEY}`
  },
  body: JSON.stringify({
    id: "s8k2jsk0pl" // required
  })
})
  .then((res) => res.json())
  .then((json) => console.log(json))
  .catch(console.error);

import requests

payload = {'id': 's8k2jsk0pl'}
headers = {'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'}

r = requests.put('https://api.ayrshare.com/api/post/retry',
    json=payload,
    headers=headers)

print(r.json())

<?php

$apiUrl = 'https://api.ayrshare.com/api/post/retry';
$apiKey = 'API_KEY';  // Replace 'API_KEY' with your actual API key

$headers = [
    'Content-Type: application/json',
    'Authorization: Bearer ' . $apiKey,
];

$data = json_encode([
    'id' => 's8k2jsk0pl'  // Replace with your actual ID
]);

$curl = curl_init($apiUrl);
curl_setopt_array($curl, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'PUT',
    CURLOPT_HTTPHEADER => $headers,
    CURLOPT_POSTFIELDS => $data
]);

$response = curl_exec($curl);

if ($response === false) {
    echo 'Curl error: ' . curl_error($curl);
} else {
    echo json_encode(json_decode($response), JSON_PRETTY_PRINT);
}

curl_close($curl);

using System;
using System.Net.Http;
using System.Text;
using System.Threading.Tasks;

namespace PostRetryPOSTRequest_csharp
{
    class PostRetry
    {
        private static readonly HttpClient client = new HttpClient();

        static async Task Main(string[] args)
        {
            string API_KEY = "API_KEY";
            string url = "https://api.ayrshare.com/api/post/retry";

            // Set up request headers
            client.DefaultRequestHeaders.Add("Authorization", "Bearer " + API_KEY);

            // Prepare JSON content
            string json = "{\"id\": \"s8k2jsk0pl\"}";
            var content = new StringContent(json, Encoding.UTF8, "application/json");

            try
            {
                // Send PATCH request
                HttpResponseMessage response = await client.PutAsync(url, content);
                response.EnsureSuccessStatusCode();

                // Read response
                string responseBody = await response.Content.ReadAsStringAsync();
                Console.WriteLine(responseBody);
            }
            catch (HttpRequestException e)
            {
                Console.WriteLine($"Error: {e.Message}");
            }
        }
    }
}

package main

import (
	"bytes"
	"encoding/json"
	"log"
	"net/http"
)

func main() {
	message := map[string]interface{}{
		"id": "s8k2jsk0pl"
	}

	bytesRepresentation, err := json.Marshal(message)
	if err != nil {
		log.Fatalln(err)
	}

	req, _ := http.NewRequest("PUT", "https://api.ayrshare.com/api/post/retry",
		bytes.NewBuffer(bytesRepresentation))

	req.Header.Add("Content-Type", "application/json; charset=UTF-8")
	req.Header.Add("Authorization", "Bearer API_KEY")

	res, err := http.DefaultClient.Do(req)
	if err != nil {
		log.Fatal("Error:", err)
	}

	res.Body.Close()
}

200: Success

{
  "status": "pending", // The post will be retried
  "id": "N7kaDiZAfwc544OBKlgc" // Ayrshare Post ID
}

{
  "action": "post",
  "status": "error",
  "code": 329,
  "message": "This post was already retried and cannot be retried again."
}

Retry to publish a post that failed with a status of "error". A retried post will be treated as a scheduled post, thus the final status can be obtained via the /history endpoint or the scheduled action webhook.

While the post is being retried, the status will be "pending". You may check on the status of the retry by calling the GET post endpoint.

The post can be retried only once. Recommend to only use if the error message indicates a retry is possible.

When retrying a failed social media post, first verify that the post hasn’t already been published. Social networks may sometimes report errors even when they’ve successfully processed and published the post.

Header Parameters

Body Parameters

id · string · required

The top-level Ayrshare Post ID. The original post must have a status of “error”.

cURL

curl \
-H "Authorization: Bearer API_KEY" \
-H 'Content-Type: application/json' \
-d '{"id": "s8k2jsk0pl"}' \
-X PUT https://api.ayrshare.com/api/post/retry

const API_KEY = "API_KEY";

fetch("https://api.ayrshare.com/api/post/retry", {
  method: "PUT",
  headers: {
    "Content-Type": "application/json",
    Authorization: `Bearer ${API_KEY}`
  },
  body: JSON.stringify({
    id: "s8k2jsk0pl" // required
  })
})
  .then((res) => res.json())
  .then((json) => console.log(json))
  .catch(console.error);

import requests

payload = {'id': 's8k2jsk0pl'}
headers = {'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'}

r = requests.put('https://api.ayrshare.com/api/post/retry',
    json=payload,
    headers=headers)

print(r.json())

<?php

$apiUrl = 'https://api.ayrshare.com/api/post/retry';
$apiKey = 'API_KEY';  // Replace 'API_KEY' with your actual API key

$headers = [
    'Content-Type: application/json',
    'Authorization: Bearer ' . $apiKey,
];

$data = json_encode([
    'id' => 's8k2jsk0pl'  // Replace with your actual ID
]);

$curl = curl_init($apiUrl);
curl_setopt_array($curl, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'PUT',
    CURLOPT_HTTPHEADER => $headers,
    CURLOPT_POSTFIELDS => $data
]);

$response = curl_exec($curl);

if ($response === false) {
    echo 'Curl error: ' . curl_error($curl);
} else {
    echo json_encode(json_decode($response), JSON_PRETTY_PRINT);
}

curl_close($curl);

using System;
using System.Net.Http;
using System.Text;
using System.Threading.Tasks;

namespace PostRetryPOSTRequest_csharp
{
    class PostRetry
    {
        private static readonly HttpClient client = new HttpClient();

        static async Task Main(string[] args)
        {
            string API_KEY = "API_KEY";
            string url = "https://api.ayrshare.com/api/post/retry";

            // Set up request headers
            client.DefaultRequestHeaders.Add("Authorization", "Bearer " + API_KEY);

            // Prepare JSON content
            string json = "{\"id\": \"s8k2jsk0pl\"}";
            var content = new StringContent(json, Encoding.UTF8, "application/json");

            try
            {
                // Send PATCH request
                HttpResponseMessage response = await client.PutAsync(url, content);
                response.EnsureSuccessStatusCode();

                // Read response
                string responseBody = await response.Content.ReadAsStringAsync();
                Console.WriteLine(responseBody);
            }
            catch (HttpRequestException e)
            {
                Console.WriteLine($"Error: {e.Message}");
            }
        }
    }
}

package main

import (
	"bytes"
	"encoding/json"
	"log"
	"net/http"
)

func main() {
	message := map[string]interface{}{
		"id": "s8k2jsk0pl"
	}

	bytesRepresentation, err := json.Marshal(message)
	if err != nil {
		log.Fatalln(err)
	}

	req, _ := http.NewRequest("PUT", "https://api.ayrshare.com/api/post/retry",
		bytes.NewBuffer(bytesRepresentation))

	req.Header.Add("Content-Type", "application/json; charset=UTF-8")
	req.Header.Add("Authorization", "Bearer API_KEY")

	res, err := http.DefaultClient.Do(req)
	if err != nil {
		log.Fatal("Error:", err)
	}

	res.Body.Close()
}

200: Success

{
  "status": "pending", // The post will be retried
  "id": "N7kaDiZAfwc544OBKlgc" // Ayrshare Post ID
}

{
  "action": "post",
  "status": "error",
  "code": 329,
  "message": "This post was already retried and cannot be retried again."
}