Docs menu

MCP tool · Creatives

import_status

The progress of an import. Each finished file gets a ref for the launch.

Read only Scope: read Pro and Scale plans Credits: Free*

What it does

Progress of the jobs started by import_link. A COMPLETED job has a ref (its URL in Apogee storage) usable in prepare_launch files. Formats are not detected here: read them from the file names, or ask.

Parameters

  • source string required

    The source returned by import_link

    One of frameio, google_drive, dropbox

  • job_ids array of strings required

    1 to 500 items · each: up to 64 characters

Example

Your assistant calls it for you when you ask in your own words. What it sends (MCP tools/call, JSON-RPC 2.0):

tools/call
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "import_status",
    "arguments": {
      "source": "frameio",
      "job_ids": [
        "120200000000000001"
      ]
    }
  }
}

The same call over HTTP with an API key, for an MCP client of your own (an assistant that signs in sends its OAuth token instead):

curl
curl -X POST https://app.apogee.ad/mcp \
  -H "Authorization: Bearer $APOGEE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"import_status","arguments":{"source":"frameio","job_ids":["120200000000000001"]}}}'

Access and cost

PlansPro and Scale.
Scoperead: a connection or an API key without it does not see this tool (scopes).
EffectReads only: nothing is changed, in Apogee or on the ad account.
CreditsFree up to the daily free reads (5,000 a day on Pro, 10,000 on Scale), then 1 credit per read. A call that fails costs nothing (credits).
Rate limit600 MCP requests per 15 minutes on Pro, 1,200 on Scale (rate limits).

In the REST API

The same thing for your own code, with an API key:

Creatives: Bring the files in before a launch. Nothing reaches Meta at this point.

Last updated on . The parameters, limits, credits and error codes of these pages are generated from the code of the Apogee API (contract 2026-10-06).

A question, something missing? Write to hello@apogee.ad.

Book a demo

Pick the time that suits you.

Open in a new tab

Loading the calendar…

Talk to Founder