Mutations
Generated from the API server source (@alternatefutures/backend 0.1.2) on every merge. Endpoint
https://api.alternatefutures.ai/graphql, header Authorization: Bearer <personal access token>.
See the GraphQL API overview for how to call it. Left out on purpose: provider-specific types, fields and arguments; operations of the retired hosting product (sites, IPFS storage, functions) and admin-only operations.
Other
beginIdentityImport
| Argument | Type | Description |
|---|---|---|
input | BeginIdentityImportInput! · BeginIdentityImportInput |
Returns DidControlChallenge! · DidControlChallenge.
completeIdentityImport
| Argument | Type | Description |
|---|---|---|
input | CompleteIdentityImportInput! · CompleteIdentityImportInput |
Returns IdentityPrincipal! · IdentityPrincipal.
rotateIdentity
| Argument | Type | Description |
|---|---|---|
input | RotateIdentityInput! · RotateIdentityInput |
Returns IdentityPrincipal! · IdentityPrincipal.
deactivateIdentity
| Argument | Type | Description |
|---|---|---|
input | DeactivateIdentityInput! · DeactivateIdentityInput |
Returns IdentityPrincipal! · IdentityPrincipal.
createIdentityVerificationPolicy
| Argument | Type | Description |
|---|---|---|
projectId | ID! | |
policy | JSON! |
Returns IdentityVerificationPolicy! · IdentityVerificationPolicy.
issueIdentityCard
| Argument | Type | Description |
|---|---|---|
input | IssueIdentityCardInput! · IssueIdentityCardInput |
Returns IssuedIdentityCard! · IssuedIdentityCard.
registerIdentityCard
| Argument | Type | Description |
|---|---|---|
projectId | ID! | |
card | JSON! |
Returns IdentityCredential! · IdentityCredential.
revokeIdentityCredential
| Argument | Type | Description |
|---|---|---|
input | RevokeIdentityCredentialInput! · RevokeIdentityCredentialInput |
Returns IdentityCredential! · IdentityCredential.
publishIdentityCard
| Argument | Type | Description |
|---|---|---|
input | PublishIdentityCardInput! · PublishIdentityCardInput |
Returns IdentityCardPublication! · IdentityCardPublication.
createIdentityProofRequest
| Argument | Type | Description |
|---|---|---|
input | CreateIdentityProofRequestInput! · CreateIdentityProofRequestInput |
Returns JSON!.
registerA2aAgentCard
| Argument | Type | Description |
|---|---|---|
input | RegisterA2aAgentCardInput! · RegisterA2aAgentCardInput |
Returns A2aAgentBinding! · A2aAgentBinding.
issueA2aAccessToken
| Argument | Type | Description |
|---|---|---|
input | IssueA2aAccessTokenInput! · IssueA2aAccessTokenInput |
Returns A2aAccessToken! · A2aAccessToken.
issueIdentityDelegation
| Argument | Type | Description |
|---|---|---|
input | IssueIdentityDelegationInput! · IssueIdentityDelegationInput |
Returns IssuedIdentityDelegation! · IssuedIdentityDelegation.
authorizeCapabilityInvocation
| Argument | Type | Description |
|---|---|---|
projectId | ID! | |
credentialId | ID! | |
invocation | JSON! |
Returns JSON!.
submitSwarmRun
| Argument | Type | Description |
|---|---|---|
input | SubmitSwarmRuntimeRunInput! · SubmitSwarmRuntimeRunInput |
Returns SwarmRuntimeRun! · SwarmRuntimeRun.
replaySwarmRun
| Argument | Type | Description |
|---|---|---|
id | ID! | |
idempotencyKey | String! | |
checkpointSequence | String |
Returns SwarmRuntimeRun! · SwarmRuntimeRun.
cancelSwarmRun
| Argument | Type | Description |
|---|---|---|
id | ID! |
Returns SwarmRuntimeRun! · SwarmRuntimeRun.
registerSwarmDefinition
| Argument | Type | Description |
|---|---|---|
input | RegisterSwarmDefinitionInput! · RegisterSwarmDefinitionInput |
Returns SwarmDefinitionVersion! · SwarmDefinitionVersion.
registerSwarmDefinitionFromSpec
| Argument | Type | Description |
|---|---|---|
input | RegisterSwarmDefinitionFromSpecInput! · RegisterSwarmDefinitionFromSpecInput |
Returns SwarmDefinitionVersion! · SwarmDefinitionVersion.
rekeySwarmPolicyBundle
Re-key the project's tool-grant bundle to the swarm's newest definition (2026-09-26): project owner or admin only. Use after a deploy was refused with SWARM_POLICY_BUNDLE_STALE because a member without admin rights saved a persona. Returns the same report a registration carries.
| Argument | Type | Description |
|---|---|---|
projectId | ID! | |
swarmId | String! |
Returns SwarmPolicyRekey! · SwarmPolicyRekey.
issueSwarmDefinitionBootstrap
| Argument | Type | Description |
|---|---|---|
input | IssueSwarmDefinitionBootstrapInput! · IssueSwarmDefinitionBootstrapInput |
Returns SwarmDefinitionBootstrapCredential! · SwarmDefinitionBootstrapCredential.
revokeSwarmDefinitionBootstrap
| Argument | Type | Description |
|---|---|---|
projectId | ID! | |
grantId | ID! |
Returns Boolean!.
revokeOtherSwarmDefinitionBootstraps
| Argument | Type | Description |
|---|---|---|
projectId | ID! | |
serviceId | ID! | |
provider | String! | |
deploymentId | ID! | |
keepGrantId | ID! |
Returns Int!.
bindSwarmDeployment
| Argument | Type | Description |
|---|---|---|
input | BindSwarmDeploymentInput! · BindSwarmDeploymentInput |
Returns SwarmDeployment! · SwarmDeployment.
deploySwarmRuntime
| Argument | Type | Description |
|---|---|---|
input | DeploySwarmRuntimeInput! · DeploySwarmRuntimeInput |
Returns SwarmDeployment! · SwarmDeployment.
startSwarmDeploy
Same gates and flow as deploySwarmRuntime, but returns as soon as the deploy slot is claimed; poll swarmDeployProgress until phase is ready or failed, then read swarmDeployment. Avoids the edge's 100 s response ceiling.
| Argument | Type | Description |
|---|---|---|
input | DeploySwarmRuntimeInput! · DeploySwarmRuntimeInput |
Returns SwarmDeployProgress! · SwarmDeployProgress.
setSwarmModel
acc swarms model set: overwrite the project's model-provider config server-side with a listed provider/model, always through the platform proxy; the runtime reads it at boot. Every deploy re-renders the config from the model the agents declare (2026-09-26), so a model set here lasts only until the next deploy. compat/<model> with baseUrl (a self-hosted endpoint) and a project's own provider key are refused since 2026-09-26 (SWARM_MODEL_UNSUPPORTED): bring-your-own-key is an Org › Models setting.
| Argument | Type | Description |
|---|---|---|
projectId | ID! | |
model | String! | |
baseUrl | String | Refused since 2026-09-26 (SWARM_MODEL_UNSUPPORTED); kept so older clients get a coded error. |
Returns SwarmModelConfig! · SwarmModelConfig.
connectSwarmDiscord
Connect a Discord channel to a swarm (E-MVP M4): verifies the bot token with Discord (bot accounts only) and that the bot can see the channel, stores the token as a project secret and upserts the channel in the map. Applied by the next deploy (the bridge sidecar reads the map at deploy and the token at boot). Audited; the token is never returned or logged.
| Argument | Type | Description |
|---|---|---|
input | ConnectSwarmDiscordInput! · ConnectSwarmDiscordInput |
Returns SwarmDiscordConnection! · SwarmDiscordConnection.
disconnectSwarmDiscord
Remove one channel (channelId) or, without it, the whole connection including the stored token. Applied by the next deploy.
| Argument | Type | Description |
|---|---|---|
projectId | ID! | |
swarmId | String! | |
channelId | String |
Returns SwarmDiscordConnection! · SwarmDiscordConnection.
stopSwarmDeployment
| Argument | Type | Description |
|---|---|---|
projectId | ID! | |
swarmId | String! |
Returns SwarmDeployment! · SwarmDeployment.
scaleSwarmDeployment
| Argument | Type | Description |
|---|---|---|
projectId | ID! | |
swarmId | String! | |
replicas | Int | |
min | Int | |
max | Int | |
idempotencyKey | String! |
Returns SwarmDeployment! · SwarmDeployment.
decideSwarmRunApproval
| Argument | Type | Description |
|---|---|---|
id | ID! | |
input | DecideSwarmRuntimeApprovalInput! · DecideSwarmRuntimeApprovalInput |
Returns SwarmRuntimeRun! · SwarmRuntimeRun.
controlRuntimeAgent
| Argument | Type | Description |
|---|---|---|
projectId | ID! | |
swarmId | String | |
agentId | String! | |
action | RuntimeAgentAction! · RuntimeAgentAction | |
idempotencyKey | String! |
Returns RuntimeAgentLifecycleResult! · RuntimeAgentLifecycleResult.
forkRuntimeAgent
| Argument | Type | Description |
|---|---|---|
projectId | ID! | |
swarmId | String | |
agentId | String! | |
version | String! | |
idempotencyKey | String! |
Returns RuntimeAgentForkResult! · RuntimeAgentForkResult.
verifyRuntimeState
| Argument | Type | Description |
|---|---|---|
projectId | ID! | |
swarmId | String | |
agentId | String! |
Returns RuntimeStateVerification! · RuntimeStateVerification.
attestRuntimeAgent
| Argument | Type | Description |
|---|---|---|
projectId | ID! | |
swarmId | String | |
agentId | String! | |
nonce | String! |
Returns RuntimeTeeAttestation! · RuntimeTeeAttestation.
registerRuntimeMcpServer
| Argument | Type | Description |
|---|---|---|
projectId | ID! | |
swarmId | String | |
server | RuntimeMcpServerInput! · RuntimeMcpServerInput | |
idempotencyKey | String! |
Returns RuntimeMcpRegistration! · RuntimeMcpRegistration.
testRuntimeModel
| Argument | Type | Description |
|---|---|---|
projectId | ID! | |
swarmId | String | |
model | String | |
force | Boolean! |
Returns RuntimeModelDiagnostic! · RuntimeModelDiagnostic.
setRuntimeSecret
acc secrets set: store one runtime secret for the project (bot tokens, policy bundles). OPENAI_API_KEY and ANTHROPIC_API_KEY are refused since 2026-09-26 (SWARM_MODEL_KEY_NOT_ALLOWED): a deployed swarm always runs through the platform inference; bring-your-own-key is an Org › Models setting.
| Argument | Type | Description |
|---|---|---|
projectId | ID! | |
name | String! | |
value | String! |
Returns RuntimeSecretReference! · RuntimeSecretReference.
Auth - SDK token exchange
loginWithPersonalAccessToken
Exchange a Personal Access Token for a short-lived access token. Used by the SDK to authenticate subsequent requests.
| Argument | Type | Description |
|---|---|---|
data | LoginWithPersonalAccessTokenDataInput! · LoginWithPersonalAccessTokenDataInput |
Returns String!.
Auth
createPersonalAccessToken
| Argument | Type | Description |
|---|---|---|
name | String! | |
expiresAt | Date |
Returns PersonalAccessTokenCreated! · PersonalAccessTokenCreated.
deletePersonalAccessToken
| Argument | Type | Description |
|---|---|---|
id | ID! |
Returns Boolean!.
Projects
createProject
| Argument | Type | Description |
|---|---|---|
data | CreateProjectDataInput! · CreateProjectDataInput |
Returns Project! · Project.
updateProject
| Argument | Type | Description |
|---|---|---|
id | ID! | |
data | UpdateProjectDataInput! · UpdateProjectDataInput |
Returns Project! · Project.
deleteProject
| Argument | Type | Description |
|---|---|---|
id | ID! |
Returns Boolean!.
projectChatSession
Mint a single-use join ticket (plus room id, relay URL and room secret) for a project's chat. Requires project access; organization projects only. Relay-blind, not end-to-end: the platform can read project chat.
| Argument | Type | Description |
|---|---|---|
projectId | ID! |
Returns ProjectChatSession! · ProjectChatSession.
publicChatTicket
Mint a single-use join ticket for the hosted public chat. Requires only an authenticated caller: no org or project check. The ticket is NOT bound to a room: the platform never learns which public rooms exist or who is in them, only that this user opened chat.
Returns PublicChatTicket! · PublicChatTicket.
Services
createService
| Argument | Type | Description |
|---|---|---|
input | CreateServiceInput! · CreateServiceInput |
Returns Service! · Service.
updateService
| Argument | Type | Description |
|---|---|---|
serviceId | ID! | |
input | UpdateServiceInput! · UpdateServiceInput |
Returns Service! · Service.
updateServicePriority
| Argument | Type | Description |
|---|---|---|
serviceId | ID! | |
shutdownPriority | Int! |
Returns Service! · Service.
deleteService
| Argument | Type | Description |
|---|---|---|
id | ID! |
Returns Service! · Service.
Attestation registry (org allowlist; AF hosts, org authors)
addAttestationMeasurement
Bless a build measurement (compose_hash) in the active org's allowlist.
| Argument | Type | Description |
|---|---|---|
input | AddAttestationMeasurementInput! · AddAttestationMeasurementInput |
Returns AttestationMeasurement! · AttestationMeasurement.
revokeAttestationMeasurement
Revoke a blessed measurement. Idempotent; revocation retires every identity minted from it.
| Argument | Type | Description |
|---|---|---|
id | ID! |
Returns AttestationMeasurement! · AttestationMeasurement.
registerAttestedIdentity
Verify a server's quote (Intel DCAP roots, in-process) and record its identity. Requires the quote's measurement to be ACTIVE in the active org's allowlist and the quote's report_data to bind the pubkey.
| Argument | Type | Description |
|---|---|---|
input | RegisterAttestedIdentityInput! · RegisterAttestedIdentityInput |
Returns AttestedIdentity! · AttestedIdentity.
Agent chat
createAgent
| Argument | Type | Description |
|---|---|---|
input | CreateAgentInput! · CreateAgentInput |
Returns Agent! · Agent.
createChat
| Argument | Type | Description |
|---|---|---|
input | CreateChatInput! · CreateChatInput |
Returns Chat! · Chat.
sendMessage
| Argument | Type | Description |
|---|---|---|
input | SendMessageInput! · SendMessageInput |
Returns Message! · Message.
deleteChat
| Argument | Type | Description |
|---|---|---|
id | ID! |
Returns Boolean!.
Observability settings
updateObservabilitySettings
| Argument | Type | Description |
|---|---|---|
projectId | ID! | |
input | UpdateObservabilitySettingsInput! · UpdateObservabilitySettingsInput |
Returns ObservabilitySettings! · ObservabilitySettings.
Templates
deployFromTemplate
| Argument | Type | Description |
|---|---|---|
input | DeployFromTemplateInput! · DeployFromTemplateInput |
Returns a deployment object for the service's compute tier (provider-specific, not documented here). †
deployCompositeTemplate
| Argument | Type | Description |
|---|---|---|
input | DeployCompositeTemplateInput! · DeployCompositeTemplateInput |
Returns CompositeDeploymentResult! · CompositeDeploymentResult.
Service environment variables
setServiceEnvVar
| Argument | Type | Description |
|---|---|---|
serviceId | ID! | |
key | String! | |
value | String! | |
secret | Boolean |
Returns ServiceEnvVar! · ServiceEnvVar.
deleteServiceEnvVar
| Argument | Type | Description |
|---|---|---|
serviceId | ID! | |
key | String! |
Returns Boolean!.
bulkSetServiceEnvVars
| Argument | Type | Description |
|---|---|---|
serviceId | ID! | |
vars | [EnvVarInput!]! · EnvVarInput |
Returns [ServiceEnvVar!]! · ServiceEnvVar.
revealServiceEnvVar
| Argument | Type | Description |
|---|---|---|
serviceId | ID! | |
key | String! |
Returns String!.
Service port configuration
setServicePort
| Argument | Type | Description |
|---|---|---|
serviceId | ID! | |
containerPort | Int! | |
publicPort | Int | |
protocol | String |
Returns ServicePort! · ServicePort.
deleteServicePort
| Argument | Type | Description |
|---|---|---|
serviceId | ID! | |
containerPort | Int! |
Returns Boolean!.
Service linking
linkServices
| Argument | Type | Description |
|---|---|---|
sourceServiceId | ID! | |
targetServiceId | ID! | |
alias | String |
Returns ServiceLink! · ServiceLink.
unlinkServices
| Argument | Type | Description |
|---|---|---|
sourceServiceId | ID! | |
targetServiceId | ID! |
Returns Boolean!.
Deployment file access (files tab)
writeServiceFile
| Argument | Type | Description |
|---|---|---|
serviceId | ID! | |
path | String! | |
content | String! |
Returns ServiceFileWriteResult! · ServiceFileWriteResult.
createServiceDirectory
| Argument | Type | Description |
|---|---|---|
serviceId | ID! | |
path | String! |
Returns Boolean!.
renameServiceFile
| Argument | Type | Description |
|---|---|---|
serviceId | ID! | |
fromPath | String! | |
toPath | String! |
Returns Boolean!.
deleteServiceFile
| Argument | Type | Description |
|---|---|---|
serviceId | ID! | |
path | String! |
Returns Boolean!.
Feedback
submitFeedback
| Argument | Type | Description |
|---|---|---|
input | SubmitFeedbackInput! · SubmitFeedbackInput |
Returns FeedbackReport! · FeedbackReport.
GitHub deploy
beginGithubInstallationClaim
Begin a one-use GitHub user-authorization proof bound to the caller, AF organization, and exact installation id returned by GitHub's setup URL.
| Argument | Type | Description |
|---|---|---|
installationId | String! | |
orgId | ID |
Returns GithubInstallationClaim! · GithubInstallationClaim.
syncGithubInstallation
Create or grant an installation only after exchanging a GitHub user OAuth code and proving that user can access the exact App installation.
| Argument | Type | Description |
|---|---|---|
state | String! | |
code | String! |
Returns GithubInstallationSyncResult! · GithubInstallationSyncResult.
refreshGithubInstallations
Live-pull all accessible App installations from GitHub into the local DB and return them. Slow path: UI uses this only on explicit Refresh / post-install.
| Argument | Type | Description |
|---|---|---|
orgId | ID |
Returns [GithubInstallation!]! · GithubInstallation.
uninstallGithubInstallation
Remove only this AF organization's installation grant and detach its services. GitHub-wide uninstall remains an installation-admin action on github.com and is reconciled by the signed deletion webhook.
| Argument | Type | Description |
|---|---|---|
installationId | ID! | |
orgId | ID |
Returns Boolean!.
createGithubService
| Argument | Type | Description |
|---|---|---|
input | CreateGithubServiceInput! · CreateGithubServiceInput |
Returns Service! · Service.
connectGithubRepo
| Argument | Type | Description |
|---|---|---|
input | ConnectGithubRepoInput! · ConnectGithubRepoInput |
Returns Service! · Service.
redeployGithubService
Trigger a new build. With no sha, builds the tip of the tracked branch (default behaviour, used by top-level Rebuild). With a sha (7-40 char hex commit SHA), rebuilds that exact commit: used by the per-row rebuild button in build history.
| Argument | Type | Description |
|---|---|---|
serviceId | ID! | |
sha | String |
Returns BuildJob! · BuildJob.
† Some fields, arguments or return types are omitted from this page: provider-specific ones, or ones that belong to retired or admin-only surfaces.