CreateAgentSessionInput

Create an owner/app-scoped session with pinned human mode, project/grid context, model, policy, registry, and provider disclosure choice.

input CreateAgentSessionInput {
  idempotencyKey: String!
  appId: BigInt!
  projectId: String
  gridId: BigInt
  mode: CrowdyStudioAgentMode!
  requestedModel: String
  providerDataConsent: Boolean
}

Fields

CreateAgentSessionInput.idempotencyKey ● String! non-null scalar

Required retry key. Same owner, operation, key, and input replay the first result; changed input returns IDEMPOTENCY_CONFLICT.

CreateAgentSessionInput.appId ● BigInt! non-null scalar

App tenant; the bearer credential must be an unexpired app token for this exact app and the caller must hold use_studio_agent.

CreateAgentSessionInput.projectId ● String scalar

Optional private owner project UUID. Required for BUILD; cross-owner/app ids return the same not-found shape.

CreateAgentSessionInput.gridId ● BigInt scalar

Optional selected grid context; selection grants no authority.

CreateAgentSessionInput.mode ● CrowdyStudioAgentMode! non-null enum

Human-selected initial ASK, BUILD, or PLAY mode.

CreateAgentSessionInput.requestedModel ● String scalar

Optional requested allowlisted model. Omit for the platform default.

CreateAgentSessionInput.providerDataConsent ● Boolean scalar

Optional explicit first-use consent for selected private project source. Omit/false for message-only or metadata-only sessions.

Member Of

crowdyStudioAgentCreateSession mutation