Get organization context

GET
/organizations/current/context

Returns a markdown briefing on the organization your API key belongs to. It covers identity, balance and where to add credit, dashboard links, projects, opportunity counts, the operating guide for building an opportunity, and any policies the organization set for task and panel descriptions. Identity, balance and dashboard links also come back as structured fields.

Authorization

apiKey
Authorization<token>

API key as Bearer token: Authorization: Bearer

In: header

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://terac.com/api/external/v2/organizations/current/context"
{
  "markdown": "string",
  "organizationId": "string",
  "organizationName": "string",
  "organizationSlug": "string",
  "balanceDollars": 0,
  "dashboard": {
    "home": "string",
    "opportunities": "string",
    "drafts": "string",
    "feasibility": "string",
    "finance": "string",
    "api_keys": "string"
  }
}
{
  "code": "BAD_REQUEST",
  "message": "Invalid input data",
  "issues": []
}

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "API key required. Include Authorization: Bearer <key> header."
  }
}

{
  "error": {
    "code": "FORBIDDEN",
    "message": "This account is not permitted to use the API."
  }
}

{
  "code": "NOT_FOUND",
  "message": "Not found",
  "issues": []
}
{
  "error": {
    "code": "RATE_LIMITED",
    "message": "Rate limit exceeded. Retry after 61 seconds."
  }
}
{
  "code": "INTERNAL_SERVER_ERROR",
  "message": "Internal server error",
  "issues": []
}

Overview

OpenAPI reference for the Terac External API.

Submit a feasibility request POST

Submit a feasibility request: can Terac source a panel for this task, and at what CPI (cost per participant). This is an async request-reply. The response comes back immediately with status RECEIVED and no CPI (costPerParticipant is null). Terac prices it out of band, either automatically within seconds or by routing it to a person, so poll GET /feasibility/requests/{requestId} rather than assuming a turnaround. Only what you send here is priced: taskDescription, panelDescription, and the count and timeline. The filters, screening questions and tasks on the opportunity you build later are not part of the brief that was priced, so a confirmed CPI applies to the scope described here and not to a materially different one. Once RESPONDED, create the opportunity with POST /opportunities and pass feasibility_request_id to price it from that confirmed CPI (Terac skips the autonomous estimate), then launch it. The request stays RESPONDED until that study launches, and is closed as won at launch rather than at create.