Skip to main content
POST
Bulk import GEO prompts

Authorizations

Authorization
string
header
required

Send your API key in the Authorization header as Bearer API_KEY. Account API keys work in every workspace you belong to: send X-Notra-Organization-Id with the workspace id or slug to choose one. Workspace endpoints require it when you belong to more than one workspace; GET /v1/me/workspaces works without it. Organization keys only accept their own workspace there.

Path Parameters

projectId
string
required
Minimum string length: 1
Pattern: ^[A-Za-z0-9_-]{1,100}$
Example:

"b1f2c3d4-0000-4000-8000-000000000000"

Body

application/json
rows
object[]
Required array length: 1 - 500 elements
csv
string

Raw CSV text with a prompt column (optionally enabled). Used when rows is omitted.

Required string length: 1 - 1048576

Response

Prompts imported successfully

imported
integer
required

Prompts added as new custom prompts.

updated
integer
required

Always 0: existing prompts are never changed by an import.

skipped
integer
required

Rows not added because the prompt was blank or already tracked, or repeated in the import. Compared case-insensitively.

issues
object[]
required

Rows rejected while parsing CSV. Always empty for rows.

organization
object
required