Skip to main content
Every cursor.api.* operation is listed below with parameter shapes and return types from the plugin Zod schemas.
New to Corsair? See API access, authentication, and error handling.

​
Account

​
getMe

account.getMe Retrieve API key information including name, creation date, and owner email Risk: read 
await corsair.cursor.api.account.getMe({});
Input: empty object Output
NameTypeRequiredDescription
apiKeyNamestringYes—
createdAtstringYes—
userEmailstringNo—

​
Agents

​
getConversation

agents.getConversation Retrieve the conversation history for a specific cloud agent Risk: read 
await corsair.cursor.api.agents.getConversation({});
Input
NameTypeRequiredDescription
idstringYes—
Output
NameTypeRequiredDescription
idstringYes—
messagesobject[]Yes—
{
  id?: string,
  text?: string,
  type?: user_message | assistant_message
}[]

​
list

agents.list Retrieve a paginated list of Cursor Cloud agents Risk: read 
await corsair.cursor.api.agents.list({});
Input
NameTypeRequiredDescription
limitnumberNo—
cursorstringNo—
Output
NameTypeRequiredDescription
agentsobject[]Yes—
nextCursorstringNo—
{
  id?: string,
  name?: string,
  source?: {
    ref?: string,
    repository?: string
  },
  status?: RUNNING | FINISHED | ERROR | CREATING | EXPIRED,
  target?: {
    url?: string,
    prUrl?: string,
    branchName?: string,
    autoCreatePr?: boolean,
    skipReviewerRequest?: boolean,
    openAsCursorGithubApp?: boolean
  },
  summary?: string,
  createdAt?: string
}[]

​
Models

​
list

models.list Retrieve the list of available AI models in Cursor Risk: read 
await corsair.cursor.api.models.list({});
Input: empty object Output
NameTypeRequiredDescription
modelsstring[]Yes—

​
Repositories

​
list

repositories.list List GitHub repositories accessible to the authenticated user Risk: read 
await corsair.cursor.api.repositories.list({});
Input: empty object Output
NameTypeRequiredDescription
repositoriesobject[]Yes—
{
  name?: string,
  owner?: string,
  repository?: string
}[]