computer agents developers

Create resource

POST/v1/servers

Create a managed resource such as a web app, function, auth module, or agent runtime.

How to call this endpoint

Every ACP API request uses bearer authentication. The examples here show the actual request path, auth header, and body shape that the platform expects.

Path, query, and header parameters

These parameters control which ACP object the endpoint acts on and how the request is processed.

Path parameters
None.
Query parameters
None.

Body schema

Content type: application/json · Required

FieldTypeRequiredDescription
projectIdstringNoOptional project that owns this resource.
namestringYesHuman-readable resource name.
descriptionstringNoDescription of the resource and what it serves.
kindweb_app | function | auth | agent_runtimeYesResource type to provision.
sourceTypestringNoSource backing the resource, such as an environment workspace.
sourceEnvironmentIdstringNoSource computer used for builds or runtime code.
sourcePathstringNoRelative source path inside the connected computer.
regionstringNoDeployment region.
runtimestringNoRuntime identifier used by the resource.
authModepublic | privateNoAccess mode for the deployed endpoint.
serviceUrlstringNoExisting service URL if managed externally.
customDomainstringNoCustom domain bound to the resource.
cloudRunServiceNamestringNoBacking Cloud Run service name when applicable.
imageUrlstringNoContainer image reference for runtime resources.
statusdraft | deploying | deployed | failed | inactiveNoInitial or desired lifecycle status.
lastDeployedAtstringNo—
metadataobjectNoAdditional resource metadata.

What the API returns

Each response code below includes the documented payload shape for the ACP API.

201Resource createdapplication/json
FieldTypeRequiredDescription
serverobjectNo—
server.idstringNoUnique identifier.
server.userIdstringNoUser ID.
server.projectIdstringNoProject ID.
server.namestringNoHuman-readable name.
server.descriptionstringNoHuman-readable description.
server.kindweb_app | function | auth | agent_runtimeNo—
server.sourceTypestringNo—
server.sourceEnvironmentIdstringNo—
server.sourcePathstringNoWorkspace-relative file path.
server.regionstringNo—
server.runtimestringNo—
server.authModepublic | privateNo—
server.serviceUrlstringNo—
server.customDomainstringNo—
server.cloudRunServiceNamestringNo—
server.imageUrlstringNo—
server.statusdraft | deploying | deployed | failed | inactiveNoCurrent lifecycle status.
server.lastDeployedAtstringNo—
server.metadataobjectNoFree-form metadata object.
server.createdAtstringNoISO 8601 timestamp.
server.updatedAtstringNoISO 8601 timestamp.
Create resource
Loading...
Response 201
Loading...
See the ACP quickstart and SDK flow