at.happyproto.server.getInstance
{
"$type": "com.atproto.lexicon.schema",
"defs": {
"instance": {
"description": "A customer's HappyView instance. Never carries the provisioner's placement or internal fields.",
"properties": {
"createdAt": {
"format": "datetime",
"type": "string"
},
"id": {
"description": "A UUID.",
"type": "string"
},
"operation": {
"description": "The change in progress, if any.",
"ref": "#operation",
"type": "ref"
},
"plan": {
"description": "The plan's id.",
"type": "string"
},
"slug": {
"type": "string"
},
"state": {
"knownValues": [
"provisioning",
"running",
"stopped",
"failed",
"deleting"
],
"type": "string"
},
"url": {
"format": "uri",
"type": "string"
},
"version": {
"description": "The HappyView release it runs.",
"type": "string"
}
},
"required": [
"id",
"slug",
"url",
"plan",
"version",
"state",
"createdAt"
],
"type": "object"
},
"main": {
"description": "One of the caller's own instances. Customers only.",
"errors": [
{
"description": "This endpoint requires an authenticated caller.",
"name": "AuthRequired"
},
{
"description": "The caller is not a HappyProto customer, or the provisioner refused them.",
"name": "Forbidden"
},
{
"description": "id is not a UUID.",
"name": "InvalidRequest"
},
{
"description": "No such instance, or it is not the caller's. The two are indistinguishable.",
"name": "NotFound"
},
{
"description": "Passed through from the provisioner.",
"name": "InvalidSlug"
},
{
"description": "Passed through from the provisioner.",
"name": "SlugTaken"
},
{
"description": "Passed through from the provisioner.",
"name": "NotEntitled"
},
{
"description": "Passed through from the provisioner.",
"name": "InstanceLimit"
},
{
"description": "Passed through from the provisioner.",
"name": "NoCapacity"
},
{
"description": "Passed through from the provisioner.",
"name": "OperationInProgress"
},
{
"description": "The provisioner is unreachable, not configured, or answered with an error it does not explain to callers.",
"name": "Upstream"
}
],
"output": {
"encoding": "application/json",
"schema": {
"properties": {
"instance": {
"ref": "#instance",
"type": "ref"
}
},
"required": [
"instance"
],
"type": "object"
}
},
"parameters": {
"properties": {
"id": {
"description": "The instance's UUID.",
"type": "string"
}
},
"required": [
"id"
],
"type": "params"
},
"type": "query"
},
"operation": {
"properties": {
"error": {
"description": "The provisioner's error code, when it failed.",
"type": "string"
},
"id": {
"type": "string"
},
"kind": {
"knownValues": [
"create",
"update",
"upgrade",
"stop",
"start",
"destroy"
],
"type": "string"
},
"status": {
"knownValues": [
"pending",
"running",
"succeeded",
"failed"
],
"type": "string"
},
"step": {
"description": "The step it last reached.",
"type": "string"
}
},
"required": [
"id",
"kind",
"status"
],
"type": "object"
}
},
"id": "at.happyproto.server.getInstance",
"lexicon": 1
}
Metadata
- DID
-
did:plc:mo7vq4jbioxwafy5zkcc3eux - CID
-
bafyreicw7ltwaxaeivjwuldjx6pil6d7ouocki6ptjuqzmfgpn2gvs36ky - Indexed At
- 2026-10-19 18:20 UTC
- AT-URI
-
at://did:plc:mo7vq4jbioxwafy5zkcc3eux/com.atproto.lexicon.schema/at.happyproto.server.getInstance
Similar Lexicons
Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.
-
The caller's own instances. Customers only.
-
Every instance, whoever owns it, with its placement. Staff only.
-
at.happyproto.server.createInstance procedure
Create an instance for the caller, and start a job that follows its provisioning. Customers only.
-
at.happyproto.server.startInstance procedure
Start one of the caller's instances, and start a job that follows the start. Customers only.
-
at.happyproto.server.updateInstance procedure
Move one of the caller's instances to another plan or HappyView release, and start a job that follows the change. Customers only.