Confirm upload

Confirm that a media file has been successfully uploaded. This marks the file as active and returns the public URL that can be used in posts.

Important: Call this endpoint only after successfully uploading the file to the presigned URL. The system will verify the file exists in storage before confirming.

POST/v1/media/{id}/confirm

Path Parameters

idstring

Request Body

size?integer

The file size in bytes. If provided, it will be stored for reference.

Range0 < value

Response Body

curl -X POST "https://api.outstand.so/v1/media/string/confirm" \  -H "Content-Type: application/json" \  -d '{}'
{
  "success": true,
  "data": {
    "id": "9dyJS",
    "filename": "product-image.jpg",
    "url": "https://media.outstand.so/org_abc123/550e8400-e29b-41d4-a716-446655440000/product-image.jpg",
    "content_type": "image/jpeg",
    "size": 1024000,
    "status": "active",
    "created_at": "2025-01-15T10:30:00Z",
    "expires_at": "2025-03-16T10:30:00Z"
  }
}
{
  "success": false,
  "error": "Invalid request",
  "details": {
    "filename": {
      "_errors": [
        "Required"
      ]
    }
  }
}
{
  "success": false,
  "error": "Invalid request",
  "details": {
    "filename": {
      "_errors": [
        "Required"
      ]
    }
  }
}
{
  "success": false,
  "error": "Invalid request",
  "details": {
    "filename": {
      "_errors": [
        "Required"
      ]
    }
  }
}
{
  "success": false,
  "error": "Internal server error",
  "message": "Failed to generate upload URL"
}