GRgrepr
Agents

Update an agent

Updates an agent. The version must match the version the client most recently observed, else a 409 Conflict is returned.

put/v1/agents/{id}

Request

  • Base URL
    https://docs.grepr.ai (the document declares no server; this is the origin it was published from)
  • Auth
    • API key in header GREPR-API-KEY
    • or OpenID Connect (https://grepr-prod.us.auth0.com/.well-known/openid-configuration)

Path parameters

idstring required

Request body

agentMaxTokensinteger
automaticSignalMaxQueueAgeMinutesinteger
changeApprovalMode'REQUIRE_APPROVAL' | 'AUTO_APPLY' required
concurrencyLimitPolicy'QUEUE' | 'DISCARD'
descriptionstring required

What the agent handles, shown to other agents; required, like worksOnIssues, and empty for none.

enabledSkillsstring[] required
enabledToolsstring[] required
issueHandoffMode'REQUIRE_TRIAGE' | 'ALLOW_READY' required

Whether the agent may put issues in Ready; required, like worksOnIssues.

maxConcurrentInvestigationsinteger
maxTokensinteger
maxTurnsinteger
namestring required
serviceAccountIdstring required
systemPromptstring required
versioninteger
worksOnIssuesboolean required

Whether the agent files and works on issues; required, since an update replaces the agent and an omitted switch would turn issue work off unnoticed.

Response

Agent updated successfully

createdAtstring date-time required
idstring required
namestring required
organizationIdstring required
state'ACTIVE' | 'PAUSED' | 'DELETED'
updatedAtstring date-time required
versioninteger

Changes

No recorded changes to this operation across all 1 revision of this API.