Confirm a binary image upload

Confirm a prepared mediaImport upload descriptor with the original JPEG, PNG or WebP bytes (at most 3145728 bytes). The byte length and SHA-256 must match the descriptor. For file references or larger local files, use the documented media tools and SDK multipart workflow.

POST/api/v1/media/import

Authorization

AuthorizationBearer token · headerrequired

Influence scoped API key or supported OAuth access token. Keep credentials out of URLs and tool input.

Header parameters

X-Publish-ConfirmationConfirmationCapabilityrequired

The exact confirmationCapability returned by prepare. Send it only in this header, with the same input, before expiresAt.

min length 32 · max length 4096 · matches ^[A-Za-z0-9._~-]+$

Idempotency-KeyIdempotencyKeyrequired

Caller-generated retry identity. Preserve this key, capability and input after an uncertain response.

min length 16 · max length 200 · matches ^[A-Za-z0-9._:-]+$

X-Publish-Uploadstringrequired

encodeURIComponent(JSON.stringify(upload)) from the prepared mediaImport input. The decoded object follows BinaryUploadDescriptor; the encoded header is at most 4096 characters.

max length 4096

Request body

requiredapplication/octet-stream

string<binary>

Responses

200

Media result; inspect ok and the asset status.

One of:

object

okbooleanrequired

output__schema0required

Show properties

__schema0

toolNamestringrequired

Allowed:adAuditQuoteadAuditStartadAuditGetadAuditListsearchfetchprofileGetconnectionStatusGetaccountListwhatsappContactListwhatsappTemplateListwhatsappMediaListcampaignGetcampaignListcampaignDraftSavemediaListmediaImportmediaUploadCreatemediaUploadPartmediaUploadCompletemediaUploadGetmediaUploadAbortmediaGetcampaignReviewcampaignReviewGetcampaignReviewExecutecampaignScheduleBatchReviewcampaignScheduleBatchExecutescheduleListbrandContextGetinsightsAccountListinsightsPostListinsightsRefreshcampaignPlanGetcampaignPlanGenerateimageGenerationQuoteimageGenerationStartimageGenerationListintegrationListgroupListintegrationSchemadevtoOrganizationListdevtoTagListdiscordChannelListdiscourseCategoryListdiscourseTagListdiscourseTopicSearchdribbbleTeamListghostAuthorListghostNewsletterListghostTagListghostTierListhashnodePublicationListlemmyCommunitySearchlistmonkListsGetlistmonkTemplateListmattermostChannelListmeweGroupListpinterestBoardListredditSubredditRequirementsGetredditSubredditSearchslackChannelListteamsChannelListtiktokCreatorInfoGetvkDestinationListwhopCompanyListwhopExperienceListwordpressCategoryListwordpressPostTypeListwordpressTagListwrapcastChannelSearchintegrationSchedulePostToolpostsListToolpostSettingsToolgenerateVideoOptionsvideoFunctionToolgenerateVideoToolgenerateImageTooluploadFromUrlTool

object

errorobjectrequired

Show properties

codestringrequired

Allowed:INVALID_INPUTFORBIDDENNOT_FOUNDCONFLICTFEATURE_DISABLEDCONFIRMATION_REQUIREDCONFIRMATION_INVALIDUPSTREAM_FAILEDNEEDS_REVIEWINTERNAL

messagestringrequired

min length 1 · max length 2048

retryablebooleanrequired

okbooleanrequired

toolNamestringrequired

400

Invalid request. Query parameters are not accepted. Tool validation failures may use a tool error envelope.

Any of:

TransportError

errorobjectrequired

Show properties

codestringrequired

messagestringrequired

retryablebooleanrequired

ToolError

errorobjectrequired

Show properties

codestringrequired

Allowed:INVALID_INPUTFORBIDDENNOT_FOUNDCONFLICTFEATURE_DISABLEDCONFIRMATION_REQUIREDCONFIRMATION_INVALIDUPSTREAM_FAILEDNEEDS_REVIEWINTERNAL

messagestringrequired

min length 1 · max length 2048

retryablebooleanrequired

okbooleanrequired

toolNamestringrequired

401

Missing, invalid or expired bearer credential.

errorobjectrequired

Show properties

codestringrequired

messagestringrequired

retryablebooleanrequired

403

The credential lacks required permissions.

errorobjectrequired

Show properties

codestringrequired

messagestringrequired

retryablebooleanrequired

404

The machine API or requested tool is unavailable.

errorobjectrequired

Show properties

codestringrequired

messagestringrequired

retryablebooleanrequired

413

The request exceeds the byte limit.

errorobjectrequired

Show properties

codestringrequired

Allowed:INVALID_INPUTFORBIDDENNOT_FOUNDCONFLICTFEATURE_DISABLEDCONFIRMATION_REQUIREDCONFIRMATION_INVALIDUPSTREAM_FAILEDNEEDS_REVIEWINTERNAL

messagestringrequired

min length 1 · max length 2048

retryablebooleanrequired

okbooleanrequired

toolNamestringrequired

429

Rate limit exceeded. The error is retryable.

errorobjectrequired

Show properties

codestringrequired

messagestringrequired

retryablebooleanrequired

503

The API or its upstream execution is unavailable.

errorobjectrequired

Show properties

codestringrequired

messagestringrequired

retryablebooleanrequired

Request

curl -X POST 'https://influence.so/api/v1/media/import' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'X-Publish-Confirmation: stringstringstringstringstringst' \
  -H 'Idempotency-Key: stringstringstri' \
  -H 'X-Publish-Upload: string' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/octet-stream' \
  -d 'string'

const response = await fetch("https://influence.so/api/v1/media/import", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "X-Publish-Confirmation": "stringstringstringstringstringst",
    "Idempotency-Key": "stringstringstri",
    "X-Publish-Upload": "string",
    "Accept": "application/json",
    "Content-Type": "application/octet-stream"
  },
  body: "string"
});

import requests

response = requests.post(
    "https://influence.so/api/v1/media/import",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "X-Publish-Confirmation": "stringstringstringstringstringst",
        "Idempotency-Key": "stringstringstri",
        "X-Publish-Upload": "string",
        "Accept": "application/json",
        "Content-Type": "application/octet-stream"
    },
    data="string",
)

Response

{
  "ok": true,
  "output": "string",
  "toolName": "adAuditQuote"
}

{
  "error": {
    "code": "string",
    "message": "string",
    "retryable": true
  }
}

{
  "error": {
    "code": "string",
    "message": "string",
    "retryable": true
  }
}

{
  "error": {
    "code": "string",
    "message": "string",
    "retryable": true
  }
}

{
  "error": {
    "code": "string",
    "message": "string",
    "retryable": true
  }
}

{
  "error": {
    "code": "INVALID_INPUT",
    "message": "string",
    "retryable": true
  },
  "ok": false,
  "toolName": "adAuditQuote"
}

{
  "error": {
    "code": "string",
    "message": "string",
    "retryable": true
  }
}

{
  "error": {
    "code": "string",
    "message": "string",
    "retryable": true
  }
}