For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt, and this page is available as Markdown at /devbase/v1/reference.md.

Connect JSON RPC reference

Availability: The DevBase runtime and production API are not yet deployed. This page and its examples describe the committed v1 contract for integration planning; requests to the API URL will not succeed until the runtime is released.

This reference is generated from the committed devbase.v1 descriptor and method-policy inventory. It contains only RPCs available to server-side API keys. In the downloadable connect.json, top-level methods use the production baseUrl. Non-production fixtures are grouped under testEnvironment.methods; resolve testEnvironment.baseUrlEnvironmentVariable from your test configuration and never inherit the production base URL. Replace ${BASE64_SECRET_VALUE} in secret examples with a securely generated value before sending a request.

/devbase.v1.ArtifactService/CompleteArtifactUpload

  • Request: devbase.v1.CompleteArtifactUploadRequest
  • Response: devbase.v1.CompleteArtifactUploadResponse
  • API-key scopes: artifacts:write
  • Billing: free
  • Execution: synchronous

JSON fields

Request

FieldProtobuf typeRepeatedJSON shapeOneof
requestIdmessage (devbase.v1.UUIDv7)falseobject
workspaceIdmessage (devbase.v1.UUIDv7)falseobject
artifactIdmessage (devbase.v1.UUIDv7)falseobject
expectedResourceVersionint64falsestring

Response

FieldProtobuf typeRepeatedJSON shapeOneof
artifactmessage (devbase.v1.Artifact)falseobject
  • Streaming: unary JSON request and response.
curl -X POST "https://devbase.api.delino.io/devbase.v1.ArtifactService/CompleteArtifactUpload" \
  -H "Authorization: Bearer $DEVBASE_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Connect-Protocol-Version: 1' \
  -d '{"artifactId":{"value":"01900000-0000-7000-8000-000000000001"},"expectedResourceVersion":"1","requestId":{"value":"01900000-0000-7000-8000-000000000001"},"workspaceId":{"value":"01900000-0000-7000-8000-000000000001"}}'

/devbase.v1.ArtifactService/CreateArtifactDownload

  • Request: devbase.v1.CreateArtifactDownloadRequest
  • Response: devbase.v1.CreateArtifactDownloadResponse
  • API-key scopes: artifacts:read
  • Billing: free
  • Execution: synchronous

JSON fields

Request

FieldProtobuf typeRepeatedJSON shapeOneof
requestIdmessage (devbase.v1.UUIDv7)falseobject
workspaceIdmessage (devbase.v1.UUIDv7)falseobject
artifactIdmessage (devbase.v1.UUIDv7)falseobject

Response

FieldProtobuf typeRepeatedJSON shapeOneof
artifactmessage (devbase.v1.Artifact)falseobject
downloadUrlstringfalsevalue
expiresAtmessage (google.protobuf.Timestamp)falsestring
  • Streaming: unary JSON request and response.
curl -X POST "https://devbase.api.delino.io/devbase.v1.ArtifactService/CreateArtifactDownload" \
  -H "Authorization: Bearer $DEVBASE_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Connect-Protocol-Version: 1' \
  -d '{"artifactId":{"value":"01900000-0000-7000-8000-000000000001"},"requestId":{"value":"01900000-0000-7000-8000-000000000001"},"workspaceId":{"value":"01900000-0000-7000-8000-000000000001"}}'

/devbase.v1.ArtifactService/CreateArtifactUpload

  • Request: devbase.v1.CreateArtifactUploadRequest
  • Response: devbase.v1.CreateArtifactUploadResponse
  • API-key scopes: artifacts:write
  • Billing: free
  • Execution: synchronous

JSON fields

Request

FieldProtobuf typeRepeatedJSON shapeOneof
requestIdmessage (devbase.v1.UUIDv7)falseobject
workspaceIdmessage (devbase.v1.UUIDv7)falseobject
miniAppIdstringfalsevalue
namestringfalsevalue
mimeTypestringfalsevalue
sizeBytesuint64falsestring
sha256Hexstringfalsevalue
requestedRetentionmessage (google.protobuf.Duration)falsestring

Response

FieldProtobuf typeRepeatedJSON shapeOneof
artifactmessage (devbase.v1.Artifact)falseobject
uploadUrlstringfalsevalue
requiredHeadersmap<string, string>falseobject keyed by string
expiresAtmessage (google.protobuf.Timestamp)falsestring
  • Streaming: unary JSON request and response.
curl -X POST "https://devbase.api.delino.io/devbase.v1.ArtifactService/CreateArtifactUpload" \
  -H "Authorization: Bearer $DEVBASE_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Connect-Protocol-Version: 1' \
  -d '{"mimeType":"application/octet-stream","miniAppId":"example","name":"example","requestId":{"value":"01900000-0000-7000-8000-000000000001"},"requestedRetention":"1.000000001s","sha256Hex":"0000000000000000000000000000000000000000000000000000000000000000","sizeBytes":"1","workspaceId":{"value":"01900000-0000-7000-8000-000000000001"}}'

/devbase.v1.ArtifactService/DeleteArtifact

  • Request: devbase.v1.DeleteArtifactRequest
  • Response: devbase.v1.DeleteArtifactResponse
  • API-key scopes: artifacts:write
  • Billing: free
  • Execution: synchronous

JSON fields

Request

FieldProtobuf typeRepeatedJSON shapeOneof
requestIdmessage (devbase.v1.UUIDv7)falseobject
workspaceIdmessage (devbase.v1.UUIDv7)falseobject
artifactIdmessage (devbase.v1.UUIDv7)falseobject
expectedResourceVersionint64falsestring

Response

FieldProtobuf typeRepeatedJSON shapeOneof
artifactIdmessage (devbase.v1.UUIDv7)falseobject
  • Streaming: unary JSON request and response.
curl -X POST "https://devbase.api.delino.io/devbase.v1.ArtifactService/DeleteArtifact" \
  -H "Authorization: Bearer $DEVBASE_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Connect-Protocol-Version: 1' \
  -d '{"artifactId":{"value":"01900000-0000-7000-8000-000000000001"},"expectedResourceVersion":"1","requestId":{"value":"01900000-0000-7000-8000-000000000001"},"workspaceId":{"value":"01900000-0000-7000-8000-000000000001"}}'

/devbase.v1.ArtifactService/GetArtifact

  • Request: devbase.v1.GetArtifactRequest
  • Response: devbase.v1.GetArtifactResponse
  • API-key scopes: artifacts:read
  • Billing: free
  • Execution: synchronous

JSON fields

Request

FieldProtobuf typeRepeatedJSON shapeOneof
workspaceIdmessage (devbase.v1.UUIDv7)falseobject
artifactIdmessage (devbase.v1.UUIDv7)falseobject

Response

FieldProtobuf typeRepeatedJSON shapeOneof
artifactmessage (devbase.v1.Artifact)falseobject
  • Streaming: unary JSON request and response.
curl -X POST "https://devbase.api.delino.io/devbase.v1.ArtifactService/GetArtifact" \
  -H "Authorization: Bearer $DEVBASE_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Connect-Protocol-Version: 1' \
  -d '{"artifactId":{"value":"01900000-0000-7000-8000-000000000001"},"workspaceId":{"value":"01900000-0000-7000-8000-000000000001"}}'

/devbase.v1.ArtifactService/ListArtifacts

  • Request: devbase.v1.ListArtifactsRequest
  • Response: devbase.v1.ListArtifactsResponse
  • API-key scopes: artifacts:read
  • Billing: free
  • Execution: synchronous

JSON fields

Request

FieldProtobuf typeRepeatedJSON shapeOneof
workspaceIdmessage (devbase.v1.UUIDv7)falseobject
pagemessage (devbase.v1.PageRequest)falseobject

Response

FieldProtobuf typeRepeatedJSON shapeOneof
artifactsmessage (devbase.v1.Artifact)truearray
pagemessage (devbase.v1.PageInfo)falseobject
  • Streaming: unary JSON request and response.
curl -X POST "https://devbase.api.delino.io/devbase.v1.ArtifactService/ListArtifacts" \
  -H "Authorization: Bearer $DEVBASE_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Connect-Protocol-Version: 1' \
  -d '{"page":{"cursor":"","pageSize":1},"workspaceId":{"value":"01900000-0000-7000-8000-000000000001"}}'

/devbase.v1.CatalogService/GetMiniApp

  • Request: devbase.v1.GetMiniAppRequest
  • Response: devbase.v1.GetMiniAppResponse
  • API-key scopes: catalog:read
  • Billing: free
  • Execution: synchronous

JSON fields

Request

FieldProtobuf typeRepeatedJSON shapeOneof
workspaceIdmessage (devbase.v1.UUIDv7)falseobject
miniAppIdstringfalsevalue

Response

FieldProtobuf typeRepeatedJSON shapeOneof
miniAppmessage (devbase.v1.MiniAppDescriptor)falseobject
  • Streaming: unary JSON request and response.
curl -X POST "https://devbase.api.delino.io/devbase.v1.CatalogService/GetMiniApp" \
  -H "Authorization: Bearer $DEVBASE_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Connect-Protocol-Version: 1' \
  -d '{"miniAppId":"example","workspaceId":{"value":"01900000-0000-7000-8000-000000000001"}}'

/devbase.v1.CatalogService/ListMiniApps

  • Request: devbase.v1.ListMiniAppsRequest
  • Response: devbase.v1.ListMiniAppsResponse
  • API-key scopes: catalog:read
  • Billing: free
  • Execution: synchronous

JSON fields

Request

FieldProtobuf typeRepeatedJSON shapeOneof
workspaceIdmessage (devbase.v1.UUIDv7)falseobject
pagemessage (devbase.v1.PageRequest)falseobject

Response

FieldProtobuf typeRepeatedJSON shapeOneof
miniAppsmessage (devbase.v1.MiniAppDescriptor)truearray
pagemessage (devbase.v1.PageInfo)falseobject
  • Streaming: unary JSON request and response.
curl -X POST "https://devbase.api.delino.io/devbase.v1.CatalogService/ListMiniApps" \
  -H "Authorization: Bearer $DEVBASE_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Connect-Protocol-Version: 1' \
  -d '{"page":{"cursor":"","pageSize":1},"workspaceId":{"value":"01900000-0000-7000-8000-000000000001"}}'

/devbase.v1.JobService/CancelJob

  • Request: devbase.v1.CancelJobRequest
  • Response: devbase.v1.CancelJobResponse
  • API-key scopes: jobs:write
  • Billing: free
  • Execution: synchronous

JSON fields

Request

FieldProtobuf typeRepeatedJSON shapeOneof
requestIdmessage (devbase.v1.UUIDv7)falseobject
workspaceIdmessage (devbase.v1.UUIDv7)falseobject
jobIdmessage (devbase.v1.UUIDv7)falseobject
expectedResourceVersionint64falsestring

Response

FieldProtobuf typeRepeatedJSON shapeOneof
jobmessage (devbase.v1.Job)falseobject
  • Streaming: unary JSON request and response.
curl -X POST "https://devbase.api.delino.io/devbase.v1.JobService/CancelJob" \
  -H "Authorization: Bearer $DEVBASE_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Connect-Protocol-Version: 1' \
  -d '{"expectedResourceVersion":"1","jobId":{"value":"01900000-0000-7000-8000-000000000001"},"requestId":{"value":"01900000-0000-7000-8000-000000000001"},"workspaceId":{"value":"01900000-0000-7000-8000-000000000001"}}'

/devbase.v1.JobService/DeleteJob

  • Request: devbase.v1.DeleteJobRequest
  • Response: devbase.v1.DeleteJobResponse
  • API-key scopes: jobs:write
  • Billing: free
  • Execution: synchronous

JSON fields

Request

FieldProtobuf typeRepeatedJSON shapeOneof
requestIdmessage (devbase.v1.UUIDv7)falseobject
workspaceIdmessage (devbase.v1.UUIDv7)falseobject
jobIdmessage (devbase.v1.UUIDv7)falseobject
expectedResourceVersionint64falsestring

Response

FieldProtobuf typeRepeatedJSON shapeOneof
jobIdmessage (devbase.v1.UUIDv7)falseobject
  • Streaming: unary JSON request and response.
curl -X POST "https://devbase.api.delino.io/devbase.v1.JobService/DeleteJob" \
  -H "Authorization: Bearer $DEVBASE_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Connect-Protocol-Version: 1' \
  -d '{"expectedResourceVersion":"1","jobId":{"value":"01900000-0000-7000-8000-000000000001"},"requestId":{"value":"01900000-0000-7000-8000-000000000001"},"workspaceId":{"value":"01900000-0000-7000-8000-000000000001"}}'

/devbase.v1.JobService/GetJob

  • Request: devbase.v1.GetJobRequest
  • Response: devbase.v1.GetJobResponse
  • API-key scopes: jobs:read
  • Billing: free
  • Execution: synchronous

JSON fields

Request

FieldProtobuf typeRepeatedJSON shapeOneof
workspaceIdmessage (devbase.v1.UUIDv7)falseobject
jobIdmessage (devbase.v1.UUIDv7)falseobject

Response

FieldProtobuf typeRepeatedJSON shapeOneof
jobmessage (devbase.v1.Job)falseobject
  • Streaming: unary JSON request and response.
curl -X POST "https://devbase.api.delino.io/devbase.v1.JobService/GetJob" \
  -H "Authorization: Bearer $DEVBASE_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Connect-Protocol-Version: 1' \
  -d '{"jobId":{"value":"01900000-0000-7000-8000-000000000001"},"workspaceId":{"value":"01900000-0000-7000-8000-000000000001"}}'

/devbase.v1.JobService/ListJobs

  • Request: devbase.v1.ListJobsRequest
  • Response: devbase.v1.ListJobsResponse
  • API-key scopes: jobs:read
  • Billing: free
  • Execution: synchronous

JSON fields

Request

FieldProtobuf typeRepeatedJSON shapeOneof
workspaceIdmessage (devbase.v1.UUIDv7)falseobject
pagemessage (devbase.v1.PageRequest)falseobject
miniAppIdstringfalsevalue
stateenum (devbase.v1.JobState)falsestring

Response

FieldProtobuf typeRepeatedJSON shapeOneof
jobsmessage (devbase.v1.Job)truearray
pagemessage (devbase.v1.PageInfo)falseobject
  • Streaming: unary JSON request and response.
curl -X POST "https://devbase.api.delino.io/devbase.v1.JobService/ListJobs" \
  -H "Authorization: Bearer $DEVBASE_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Connect-Protocol-Version: 1' \
  -d '{"miniAppId":"example","page":{"cursor":"","pageSize":1},"state":"JOB_STATE_UNSPECIFIED","workspaceId":{"value":"01900000-0000-7000-8000-000000000001"}}'

/devbase.v1.JobService/WatchJob

  • Request: devbase.v1.WatchJobRequest
  • Response: devbase.v1.WatchJobResponse
  • API-key scopes: jobs:read
  • Billing: free
  • Execution: synchronous

JSON fields

Request

FieldProtobuf typeRepeatedJSON shapeOneof
workspaceIdmessage (devbase.v1.UUIDv7)falseobject
jobIdmessage (devbase.v1.UUIDv7)falseobject
afterResourceVersionint64falsestring

Response

FieldProtobuf typeRepeatedJSON shapeOneof
jobmessage (devbase.v1.Job)falseobjectevent
heartbeatmessage (devbase.v1.JobHeartbeat)falseobjectevent
  • Streaming: Connect server-streaming with length-prefixed JSON envelopes.
node <<'NODE' | curl --no-buffer -X POST "https://devbase.api.delino.io/devbase.v1.JobService/WatchJob" \
  -H "Authorization: Bearer $DEVBASE_API_KEY" \
  -H 'Content-Type: application/connect+json' \
  -H 'Connect-Protocol-Version: 1' \
  --data-binary @- \
  --output watchjob.connect
const body = Buffer.from(JSON.stringify({"afterResourceVersion":"1","jobId":{"value":"01900000-0000-7000-8000-000000000001"},"workspaceId":{"value":"01900000-0000-7000-8000-000000000001"}}));
const frame = Buffer.alloc(5);
frame.writeUInt32BE(body.length, 1);
process.stdout.write(Buffer.concat([frame, body]));
NODE

The response is written as Connect JSON envelopes to watchjob.connect; decode its five-byte envelopes with a Connect-capable client.

/devbase.v1.PublicTestFixtureService/RunAsync

Non-production only. This fixture is registered only with ENABLE_TEST_FIXTURE=true in a test environment. Use your configured test API base URL.

  • Request: devbase.v1.RunAsyncRequest
  • Response: devbase.v1.RunAsyncResponse
  • API-key scopes: test-fixture:execute
  • Billing: metered
  • Execution: asynchronous

JSON fields

Request

FieldProtobuf typeRepeatedJSON shapeOneof
requestIdmessage (devbase.v1.UUIDv7)falseobject
workspaceIdmessage (devbase.v1.UUIDv7)falseobject
inputstringfalsevalue
inputArtifactIdsmessage (devbase.v1.UUIDv7)truearray
secretIdsmessage (devbase.v1.UUIDv7)truearray

Response

FieldProtobuf typeRepeatedJSON shapeOneof
jobmessage (devbase.v1.Job)falseobject
  • Streaming: unary JSON request and response.
curl -X POST "$DEVBASE_TEST_API_BASE_URL/devbase.v1.PublicTestFixtureService/RunAsync" \
  -H "Authorization: Bearer $DEVBASE_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Connect-Protocol-Version: 1' \
  -d '{"input":"example","inputArtifactIds":[{"value":"01900000-0000-7000-8000-000000000001"}],"requestId":{"value":"01900000-0000-7000-8000-000000000001"},"secretIds":[{"value":"01900000-0000-7000-8000-000000000001"}],"workspaceId":{"value":"01900000-0000-7000-8000-000000000001"}}'

/devbase.v1.PublicTestFixtureService/RunStream

Non-production only. This fixture is registered only with ENABLE_TEST_FIXTURE=true in a test environment. Use your configured test API base URL.

  • Request: devbase.v1.RunStreamRequest
  • Response: devbase.v1.RunStreamResponse
  • API-key scopes: test-fixture:execute
  • Billing: metered
  • Execution: synchronous

JSON fields

Request

FieldProtobuf typeRepeatedJSON shapeOneof
requestIdmessage (devbase.v1.UUIDv7)falseobject
workspaceIdmessage (devbase.v1.UUIDv7)falseobject
inputstringfalsevalue
inputArtifactIdsmessage (devbase.v1.UUIDv7)truearray
secretIdsmessage (devbase.v1.UUIDv7)truearray

Response

FieldProtobuf typeRepeatedJSON shapeOneof
outputstringfalsevalue
sequenceuint32falsevalue
  • Streaming: Connect server-streaming with length-prefixed JSON envelopes.
node <<'NODE' | curl --no-buffer -X POST "$DEVBASE_TEST_API_BASE_URL/devbase.v1.PublicTestFixtureService/RunStream" \
  -H "Authorization: Bearer $DEVBASE_API_KEY" \
  -H 'Content-Type: application/connect+json' \
  -H 'Connect-Protocol-Version: 1' \
  --data-binary @- \
  --output watchjob.connect
const body = Buffer.from(JSON.stringify({"input":"example","inputArtifactIds":[{"value":"01900000-0000-7000-8000-000000000001"}],"requestId":{"value":"01900000-0000-7000-8000-000000000001"},"secretIds":[{"value":"01900000-0000-7000-8000-000000000001"}],"workspaceId":{"value":"01900000-0000-7000-8000-000000000001"}}));
const frame = Buffer.alloc(5);
frame.writeUInt32BE(body.length, 1);
process.stdout.write(Buffer.concat([frame, body]));
NODE

The response is written as Connect JSON envelopes to watchjob.connect; decode its five-byte envelopes with a Connect-capable client.

/devbase.v1.PublicTestFixtureService/RunSync

Non-production only. This fixture is registered only with ENABLE_TEST_FIXTURE=true in a test environment. Use your configured test API base URL.

  • Request: devbase.v1.RunSyncRequest
  • Response: devbase.v1.RunSyncResponse
  • API-key scopes: test-fixture:execute
  • Billing: metered
  • Execution: synchronous

JSON fields

Request

FieldProtobuf typeRepeatedJSON shapeOneof
requestIdmessage (devbase.v1.UUIDv7)falseobject
workspaceIdmessage (devbase.v1.UUIDv7)falseobject
inputstringfalsevalue
inputArtifactIdsmessage (devbase.v1.UUIDv7)truearray
secretIdsmessage (devbase.v1.UUIDv7)truearray

Response

FieldProtobuf typeRepeatedJSON shapeOneof
outputstringfalsevalue
  • Streaming: unary JSON request and response.
curl -X POST "$DEVBASE_TEST_API_BASE_URL/devbase.v1.PublicTestFixtureService/RunSync" \
  -H "Authorization: Bearer $DEVBASE_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Connect-Protocol-Version: 1' \
  -d '{"input":"example","inputArtifactIds":[{"value":"01900000-0000-7000-8000-000000000001"}],"requestId":{"value":"01900000-0000-7000-8000-000000000001"},"secretIds":[{"value":"01900000-0000-7000-8000-000000000001"}],"workspaceId":{"value":"01900000-0000-7000-8000-000000000001"}}'

/devbase.v1.SecretService/CreateSecret

  • Request: devbase.v1.CreateSecretRequest
  • Response: devbase.v1.CreateSecretResponse
  • API-key scopes: secrets:write
  • Billing: free
  • Execution: synchronous

JSON fields

Request

FieldProtobuf typeRepeatedJSON shapeOneof
requestIdmessage (devbase.v1.UUIDv7)falseobject
workspaceIdmessage (devbase.v1.UUIDv7)falseobject
namestringfalsevalue
valuebytesfalsestring

Response

FieldProtobuf typeRepeatedJSON shapeOneof
secretmessage (devbase.v1.Secret)falseobject
  • Streaming: unary JSON request and response.
curl -X POST "https://devbase.api.delino.io/devbase.v1.SecretService/CreateSecret" \
  -H "Authorization: Bearer $DEVBASE_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Connect-Protocol-Version: 1' \
  -d '{"name":"example","requestId":{"value":"01900000-0000-7000-8000-000000000001"},"value":"${BASE64_SECRET_VALUE}","workspaceId":{"value":"01900000-0000-7000-8000-000000000001"}}'

/devbase.v1.SecretService/DeleteSecret

  • Request: devbase.v1.DeleteSecretRequest
  • Response: devbase.v1.DeleteSecretResponse
  • API-key scopes: secrets:write
  • Billing: free
  • Execution: synchronous

JSON fields

Request

FieldProtobuf typeRepeatedJSON shapeOneof
requestIdmessage (devbase.v1.UUIDv7)falseobject
workspaceIdmessage (devbase.v1.UUIDv7)falseobject
secretIdmessage (devbase.v1.UUIDv7)falseobject
expectedResourceVersionint64falsestring

Response

FieldProtobuf typeRepeatedJSON shapeOneof
secretIdmessage (devbase.v1.UUIDv7)falseobject
  • Streaming: unary JSON request and response.
curl -X POST "https://devbase.api.delino.io/devbase.v1.SecretService/DeleteSecret" \
  -H "Authorization: Bearer $DEVBASE_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Connect-Protocol-Version: 1' \
  -d '{"expectedResourceVersion":"1","requestId":{"value":"01900000-0000-7000-8000-000000000001"},"secretId":{"value":"01900000-0000-7000-8000-000000000001"},"workspaceId":{"value":"01900000-0000-7000-8000-000000000001"}}'

/devbase.v1.SecretService/GetSecret

  • Request: devbase.v1.GetSecretRequest
  • Response: devbase.v1.GetSecretResponse
  • API-key scopes: secrets:read
  • Billing: free
  • Execution: synchronous

JSON fields

Request

FieldProtobuf typeRepeatedJSON shapeOneof
workspaceIdmessage (devbase.v1.UUIDv7)falseobject
secretIdmessage (devbase.v1.UUIDv7)falseobject

Response

FieldProtobuf typeRepeatedJSON shapeOneof
secretmessage (devbase.v1.Secret)falseobject
  • Streaming: unary JSON request and response.
curl -X POST "https://devbase.api.delino.io/devbase.v1.SecretService/GetSecret" \
  -H "Authorization: Bearer $DEVBASE_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Connect-Protocol-Version: 1' \
  -d '{"secretId":{"value":"01900000-0000-7000-8000-000000000001"},"workspaceId":{"value":"01900000-0000-7000-8000-000000000001"}}'

/devbase.v1.SecretService/ListSecrets

  • Request: devbase.v1.ListSecretsRequest
  • Response: devbase.v1.ListSecretsResponse
  • API-key scopes: secrets:read
  • Billing: free
  • Execution: synchronous

JSON fields

Request

FieldProtobuf typeRepeatedJSON shapeOneof
workspaceIdmessage (devbase.v1.UUIDv7)falseobject
pagemessage (devbase.v1.PageRequest)falseobject

Response

FieldProtobuf typeRepeatedJSON shapeOneof
secretsmessage (devbase.v1.Secret)truearray
pagemessage (devbase.v1.PageInfo)falseobject
  • Streaming: unary JSON request and response.
curl -X POST "https://devbase.api.delino.io/devbase.v1.SecretService/ListSecrets" \
  -H "Authorization: Bearer $DEVBASE_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Connect-Protocol-Version: 1' \
  -d '{"page":{"cursor":"","pageSize":1},"workspaceId":{"value":"01900000-0000-7000-8000-000000000001"}}'

/devbase.v1.SecretService/RotateSecret

  • Request: devbase.v1.RotateSecretRequest
  • Response: devbase.v1.RotateSecretResponse
  • API-key scopes: secrets:write
  • Billing: free
  • Execution: synchronous

JSON fields

Request

FieldProtobuf typeRepeatedJSON shapeOneof
requestIdmessage (devbase.v1.UUIDv7)falseobject
workspaceIdmessage (devbase.v1.UUIDv7)falseobject
secretIdmessage (devbase.v1.UUIDv7)falseobject
expectedResourceVersionint64falsestring
valuebytesfalsestring

Response

FieldProtobuf typeRepeatedJSON shapeOneof
secretmessage (devbase.v1.Secret)falseobject
  • Streaming: unary JSON request and response.
curl -X POST "https://devbase.api.delino.io/devbase.v1.SecretService/RotateSecret" \
  -H "Authorization: Bearer $DEVBASE_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Connect-Protocol-Version: 1' \
  -d '{"expectedResourceVersion":"1","requestId":{"value":"01900000-0000-7000-8000-000000000001"},"secretId":{"value":"01900000-0000-7000-8000-000000000001"},"value":"${BASE64_SECRET_VALUE}","workspaceId":{"value":"01900000-0000-7000-8000-000000000001"}}'

/devbase.v1.WebhookService/CreateWebhookEndpoint

  • Request: devbase.v1.CreateWebhookEndpointRequest
  • Response: devbase.v1.CreateWebhookEndpointResponse
  • API-key scopes: webhooks:write
  • Billing: free
  • Execution: synchronous

JSON fields

Request

FieldProtobuf typeRepeatedJSON shapeOneof
requestIdmessage (devbase.v1.UUIDv7)falseobject
workspaceIdmessage (devbase.v1.UUIDv7)falseobject
namestringfalsevalue
urlstringfalsevalue

Response

FieldProtobuf typeRepeatedJSON shapeOneof
endpointmessage (devbase.v1.WebhookEndpoint)falseobject
signingSecretstringfalsevalue
  • Streaming: unary JSON request and response.
curl -X POST "https://devbase.api.delino.io/devbase.v1.WebhookService/CreateWebhookEndpoint" \
  -H "Authorization: Bearer $DEVBASE_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Connect-Protocol-Version: 1' \
  -d '{"name":"example","requestId":{"value":"01900000-0000-7000-8000-000000000001"},"url":"https://example.com/webhook","workspaceId":{"value":"01900000-0000-7000-8000-000000000001"}}'

/devbase.v1.WebhookService/DeleteWebhookEndpoint

  • Request: devbase.v1.DeleteWebhookEndpointRequest
  • Response: devbase.v1.DeleteWebhookEndpointResponse
  • API-key scopes: webhooks:write
  • Billing: free
  • Execution: synchronous

JSON fields

Request

FieldProtobuf typeRepeatedJSON shapeOneof
requestIdmessage (devbase.v1.UUIDv7)falseobject
workspaceIdmessage (devbase.v1.UUIDv7)falseobject
endpointIdmessage (devbase.v1.UUIDv7)falseobject
expectedResourceVersionint64falsestring

Response

FieldProtobuf typeRepeatedJSON shapeOneof
endpointIdmessage (devbase.v1.UUIDv7)falseobject
  • Streaming: unary JSON request and response.
curl -X POST "https://devbase.api.delino.io/devbase.v1.WebhookService/DeleteWebhookEndpoint" \
  -H "Authorization: Bearer $DEVBASE_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Connect-Protocol-Version: 1' \
  -d '{"endpointId":{"value":"01900000-0000-7000-8000-000000000001"},"expectedResourceVersion":"1","requestId":{"value":"01900000-0000-7000-8000-000000000001"},"workspaceId":{"value":"01900000-0000-7000-8000-000000000001"}}'

/devbase.v1.WebhookService/GetWebhookEndpoint

  • Request: devbase.v1.GetWebhookEndpointRequest
  • Response: devbase.v1.GetWebhookEndpointResponse
  • API-key scopes: webhooks:read
  • Billing: free
  • Execution: synchronous

JSON fields

Request

FieldProtobuf typeRepeatedJSON shapeOneof
workspaceIdmessage (devbase.v1.UUIDv7)falseobject
endpointIdmessage (devbase.v1.UUIDv7)falseobject

Response

FieldProtobuf typeRepeatedJSON shapeOneof
endpointmessage (devbase.v1.WebhookEndpoint)falseobject
  • Streaming: unary JSON request and response.
curl -X POST "https://devbase.api.delino.io/devbase.v1.WebhookService/GetWebhookEndpoint" \
  -H "Authorization: Bearer $DEVBASE_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Connect-Protocol-Version: 1' \
  -d '{"endpointId":{"value":"01900000-0000-7000-8000-000000000001"},"workspaceId":{"value":"01900000-0000-7000-8000-000000000001"}}'

/devbase.v1.WebhookService/ListWebhookDeliveries

  • Request: devbase.v1.ListWebhookDeliveriesRequest
  • Response: devbase.v1.ListWebhookDeliveriesResponse
  • API-key scopes: webhooks:read
  • Billing: free
  • Execution: synchronous

JSON fields

Request

FieldProtobuf typeRepeatedJSON shapeOneof
workspaceIdmessage (devbase.v1.UUIDv7)falseobject
endpointIdmessage (devbase.v1.UUIDv7)falseobject
pagemessage (devbase.v1.PageRequest)falseobject

Response

FieldProtobuf typeRepeatedJSON shapeOneof
deliveriesmessage (devbase.v1.WebhookDelivery)truearray
pagemessage (devbase.v1.PageInfo)falseobject
  • Streaming: unary JSON request and response.
curl -X POST "https://devbase.api.delino.io/devbase.v1.WebhookService/ListWebhookDeliveries" \
  -H "Authorization: Bearer $DEVBASE_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Connect-Protocol-Version: 1' \
  -d '{"endpointId":{"value":"01900000-0000-7000-8000-000000000001"},"page":{"cursor":"","pageSize":1},"workspaceId":{"value":"01900000-0000-7000-8000-000000000001"}}'

/devbase.v1.WebhookService/ListWebhookEndpoints

  • Request: devbase.v1.ListWebhookEndpointsRequest
  • Response: devbase.v1.ListWebhookEndpointsResponse
  • API-key scopes: webhooks:read
  • Billing: free
  • Execution: synchronous

JSON fields

Request

FieldProtobuf typeRepeatedJSON shapeOneof
workspaceIdmessage (devbase.v1.UUIDv7)falseobject
pagemessage (devbase.v1.PageRequest)falseobject

Response

FieldProtobuf typeRepeatedJSON shapeOneof
endpointsmessage (devbase.v1.WebhookEndpoint)truearray
pagemessage (devbase.v1.PageInfo)falseobject
  • Streaming: unary JSON request and response.
curl -X POST "https://devbase.api.delino.io/devbase.v1.WebhookService/ListWebhookEndpoints" \
  -H "Authorization: Bearer $DEVBASE_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Connect-Protocol-Version: 1' \
  -d '{"page":{"cursor":"","pageSize":1},"workspaceId":{"value":"01900000-0000-7000-8000-000000000001"}}'

/devbase.v1.WebhookService/RedeliverWebhookDelivery

  • Request: devbase.v1.RedeliverWebhookDeliveryRequest
  • Response: devbase.v1.RedeliverWebhookDeliveryResponse
  • API-key scopes: webhooks:write
  • Billing: free
  • Execution: synchronous

JSON fields

Request

FieldProtobuf typeRepeatedJSON shapeOneof
requestIdmessage (devbase.v1.UUIDv7)falseobject
workspaceIdmessage (devbase.v1.UUIDv7)falseobject
deliveryIdmessage (devbase.v1.UUIDv7)falseobject
expectedResourceVersionint64falsestring

Response

FieldProtobuf typeRepeatedJSON shapeOneof
deliverymessage (devbase.v1.WebhookDelivery)falseobject
  • Streaming: unary JSON request and response.
curl -X POST "https://devbase.api.delino.io/devbase.v1.WebhookService/RedeliverWebhookDelivery" \
  -H "Authorization: Bearer $DEVBASE_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Connect-Protocol-Version: 1' \
  -d '{"deliveryId":{"value":"01900000-0000-7000-8000-000000000001"},"expectedResourceVersion":"1","requestId":{"value":"01900000-0000-7000-8000-000000000001"},"workspaceId":{"value":"01900000-0000-7000-8000-000000000001"}}'

/devbase.v1.WebhookService/RotateWebhookSecret

  • Request: devbase.v1.RotateWebhookSecretRequest
  • Response: devbase.v1.RotateWebhookSecretResponse
  • API-key scopes: webhooks:write
  • Billing: free
  • Execution: synchronous

JSON fields

Request

FieldProtobuf typeRepeatedJSON shapeOneof
requestIdmessage (devbase.v1.UUIDv7)falseobject
workspaceIdmessage (devbase.v1.UUIDv7)falseobject
endpointIdmessage (devbase.v1.UUIDv7)falseobject
expectedResourceVersionint64falsestring

Response

FieldProtobuf typeRepeatedJSON shapeOneof
endpointmessage (devbase.v1.WebhookEndpoint)falseobject
signingSecretstringfalsevalue
previousSecretExpiresAtmessage (google.protobuf.Timestamp)falsestring
  • Streaming: unary JSON request and response.
curl -X POST "https://devbase.api.delino.io/devbase.v1.WebhookService/RotateWebhookSecret" \
  -H "Authorization: Bearer $DEVBASE_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Connect-Protocol-Version: 1' \
  -d '{"endpointId":{"value":"01900000-0000-7000-8000-000000000001"},"expectedResourceVersion":"1","requestId":{"value":"01900000-0000-7000-8000-000000000001"},"workspaceId":{"value":"01900000-0000-7000-8000-000000000001"}}'

/devbase.v1.WebhookService/UpdateWebhookEndpoint

  • Request: devbase.v1.UpdateWebhookEndpointRequest
  • Response: devbase.v1.UpdateWebhookEndpointResponse
  • API-key scopes: webhooks:write
  • Billing: free
  • Execution: synchronous

JSON fields

Request

FieldProtobuf typeRepeatedJSON shapeOneof
requestIdmessage (devbase.v1.UUIDv7)falseobject
workspaceIdmessage (devbase.v1.UUIDv7)falseobject
endpointIdmessage (devbase.v1.UUIDv7)falseobject
expectedResourceVersionint64falsestring
namestringfalsevalue
urlstringfalsevalue
enabledboolfalsevalue

Response

FieldProtobuf typeRepeatedJSON shapeOneof
endpointmessage (devbase.v1.WebhookEndpoint)falseobject
  • Streaming: unary JSON request and response.
curl -X POST "https://devbase.api.delino.io/devbase.v1.WebhookService/UpdateWebhookEndpoint" \
  -H "Authorization: Bearer $DEVBASE_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Connect-Protocol-Version: 1' \
  -d '{"enabled":true,"endpointId":{"value":"01900000-0000-7000-8000-000000000001"},"expectedResourceVersion":"1","name":"example","requestId":{"value":"01900000-0000-7000-8000-000000000001"},"url":"https://example.com/webhook","workspaceId":{"value":"01900000-0000-7000-8000-000000000001"}}'

Referenced message and enum schemas

devbase.v1.Artifact

FieldProtobuf typeRepeatedJSON shapeOneof
idmessage (devbase.v1.UUIDv7)falseobject
workspaceIdmessage (devbase.v1.UUIDv7)falseobject
owningJobIdmessage (devbase.v1.UUIDv7)falseobject
namestringfalsevalue
mimeTypestringfalsevalue
sizeBytesuint64falsestring
sha256Hexstringfalsevalue
stateenum (devbase.v1.ArtifactState)falsestring
expiresAtmessage (google.protobuf.Timestamp)falsestring
resourceVersionint64falsestring
createdAtmessage (google.protobuf.Timestamp)falsestring
updatedAtmessage (google.protobuf.Timestamp)falsestring

devbase.v1.ArtifactConstraints

FieldProtobuf typeRepeatedJSON shapeOneof
acceptedMimeTypesstringtruearray
maximumObjectSizeBytesuint64falsestring
maximumInputCountuint32falsevalue
defaultRetentionmessage (google.protobuf.Duration)falsestring
maximumRetentionmessage (google.protobuf.Duration)falsestring

devbase.v1.ErrorDetail

FieldProtobuf typeRepeatedJSON shapeOneof
reasonenum (devbase.v1.ErrorReason)falsestring
requestIdmessage (devbase.v1.UUIDv7)falseobject
correlationIdstringfalsevalue
retryAfterSecondsuint32falsevalue
retryGuidanceenum (devbase.v1.RetryGuidance)falsestring
fieldViolationsmessage (devbase.v1.FieldViolation)truearray

devbase.v1.FieldViolation

FieldProtobuf typeRepeatedJSON shapeOneof
fieldstringfalsevalue
descriptionstringfalsevalue

devbase.v1.Job

FieldProtobuf typeRepeatedJSON shapeOneof
idmessage (devbase.v1.UUIDv7)falseobject
workspaceIdmessage (devbase.v1.UUIDv7)falseobject
miniAppIdstringfalsevalue
procedurestringfalsevalue
stateenum (devbase.v1.JobState)falsestring
progressPercentuint32falsevalue
attemptCountuint32falsevalue
nextAttemptAtmessage (google.protobuf.Timestamp)falsestring
terminalErrormessage (devbase.v1.ErrorDetail)falseobject
inputArtifactIdsmessage (devbase.v1.UUIDv7)truearray
resultArtifactIdsmessage (devbase.v1.UUIDv7)truearray
resourceVersionint64falsestring
createdAtmessage (google.protobuf.Timestamp)falsestring
updatedAtmessage (google.protobuf.Timestamp)falsestring
completedAtmessage (google.protobuf.Timestamp)falsestring

devbase.v1.JobHeartbeat

FieldProtobuf typeRepeatedJSON shapeOneof
resourceVersionint64falsestring
emittedAtmessage (google.protobuf.Timestamp)falsestring

devbase.v1.MiniAppDescriptor

FieldProtobuf typeRepeatedJSON shapeOneof
idstringfalsevalue
displayNamestringfalsevalue
descriptionstringfalsevalue
operationsmessage (devbase.v1.MiniAppOperation)truearray
artifactConstraintsmessage (devbase.v1.ArtifactConstraints)falseobject
maximumAttemptsuint32falsevalue
maximumDurationmessage (google.protobuf.Duration)falsestring
resourceVersionint64falsestring

devbase.v1.MiniAppOperation

FieldProtobuf typeRepeatedJSON shapeOneof
procedurestringfalsevalue
displayNamestringfalsevalue
executionModeenum (devbase.v1.ExecutionMode)falsestring
apiKeyScopesstringtruearray
delcoreMeterKeystringfalsevalue
freeboolfalsevalue

devbase.v1.PageInfo

FieldProtobuf typeRepeatedJSON shapeOneof
nextCursorstringfalsevalue

devbase.v1.PageRequest

FieldProtobuf typeRepeatedJSON shapeOneof
pageSizeuint32falsevalue
cursorstringfalsevalue

devbase.v1.Secret

FieldProtobuf typeRepeatedJSON shapeOneof
idmessage (devbase.v1.UUIDv7)falseobject
workspaceIdmessage (devbase.v1.UUIDv7)falseobject
namestringfalsevalue
resourceVersionint64falsestring
createdAtmessage (google.protobuf.Timestamp)falsestring
updatedAtmessage (google.protobuf.Timestamp)falsestring
deletedAtmessage (google.protobuf.Timestamp)falsestring

devbase.v1.UUIDv7

FieldProtobuf typeRepeatedJSON shapeOneof
valuestringfalsevalue

devbase.v1.WebhookDelivery

FieldProtobuf typeRepeatedJSON shapeOneof
idmessage (devbase.v1.UUIDv7)falseobject
workspaceIdmessage (devbase.v1.UUIDv7)falseobject
endpointIdmessage (devbase.v1.UUIDv7)falseobject
eventIdmessage (devbase.v1.UUIDv7)falseobject
jobIdmessage (devbase.v1.UUIDv7)falseobject
stateenum (devbase.v1.WebhookDeliveryState)falsestring
attemptCountuint32falsevalue
lastStatusCodeuint32falsevalue
nextAttemptAtmessage (google.protobuf.Timestamp)falsestring
createdAtmessage (google.protobuf.Timestamp)falsestring
deliveredAtmessage (google.protobuf.Timestamp)falsestring
resourceVersionint64falsestring

devbase.v1.WebhookEndpoint

FieldProtobuf typeRepeatedJSON shapeOneof
idmessage (devbase.v1.UUIDv7)falseobject
workspaceIdmessage (devbase.v1.UUIDv7)falseobject
namestringfalsevalue
urlstringfalsevalue
enabledboolfalsevalue
resourceVersionint64falsestring
createdAtmessage (google.protobuf.Timestamp)falsestring
updatedAtmessage (google.protobuf.Timestamp)falsestring

google.protobuf.Duration

JSON representation
string

google.protobuf.Timestamp

JSON representation
string

devbase.v1.ArtifactState enum values

  • ARTIFACT_STATE_UNSPECIFIED
  • ARTIFACT_STATE_PENDING_UPLOAD
  • ARTIFACT_STATE_AVAILABLE
  • ARTIFACT_STATE_DELETED
  • ARTIFACT_STATE_EXPIRED

devbase.v1.ErrorReason enum values

  • ERROR_REASON_UNSPECIFIED
  • ERROR_REASON_INVALID_ARGUMENT
  • ERROR_REASON_AUTHENTICATION_REQUIRED
  • ERROR_REASON_AUTHORIZATION_DENIED
  • ERROR_REASON_RESOURCE_NOT_FOUND
  • ERROR_REASON_IDEMPOTENCY_CONFLICT
  • ERROR_REASON_RESOURCE_VERSION_CONFLICT
  • ERROR_REASON_FAILED_PRECONDITION
  • ERROR_REASON_QUOTA_EXHAUSTED
  • ERROR_REASON_RATE_LIMITED
  • ERROR_REASON_CONCURRENCY_EXHAUSTED
  • ERROR_REASON_BILLING_BLOCKED
  • ERROR_REASON_CHECKSUM_MISMATCH
  • ERROR_REASON_DEPENDENCY_UNAVAILABLE
  • ERROR_REASON_INTERNAL

devbase.v1.ExecutionMode enum values

  • EXECUTION_MODE_UNSPECIFIED
  • EXECUTION_MODE_SYNCHRONOUS
  • EXECUTION_MODE_ASYNCHRONOUS

devbase.v1.JobState enum values

  • JOB_STATE_UNSPECIFIED
  • JOB_STATE_QUEUED
  • JOB_STATE_RUNNING
  • JOB_STATE_CANCELING
  • JOB_STATE_SUCCEEDED
  • JOB_STATE_FAILED
  • JOB_STATE_CANCELED

devbase.v1.RetryGuidance enum values

  • RETRY_GUIDANCE_UNSPECIFIED
  • RETRY_GUIDANCE_AFTER_DELAY
  • RETRY_GUIDANCE_AFTER_DEPENDENCY_RECOVERY
  • RETRY_GUIDANCE_AFTER_REAUTHENTICATION
  • RETRY_GUIDANCE_AFTER_STATE_CHANGE
  • RETRY_GUIDANCE_DO_NOT_RETRY

devbase.v1.WebhookDeliveryState enum values

  • WEBHOOK_DELIVERY_STATE_UNSPECIFIED
  • WEBHOOK_DELIVERY_STATE_PENDING
  • WEBHOOK_DELIVERY_STATE_DELIVERED
  • WEBHOOK_DELIVERY_STATE_FAILED
  • WEBHOOK_DELIVERY_STATE_CANCELED