Report action result

Correlated outcome can be succeeded or failed. Request bodies are limited to 16 KiB and results must fit the workspace’s 16 MiB logical storage budget. Reposting the same status and result is idempotent; a conflicting repeat is rejected. Delivery does not guarantee exactly-once physical execution.

POST/v1/device/{deviceId}/result

Authorization

AuthorizationBearer token (device child credential) · headerrequired

Child device credential, independently revocable from its setup token.

Path parameters

deviceIdstring<uuid>required

Header parameters

x-openlaunch-workspacestringrequired

Workspace routing identifier for the device credential; not a secret.

matches ^[a-f0-9]{64}$

Request body

requiredapplication/json

actionIdstring<uuid>required

matches ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$

statusstringrequired

Allowed:succeededfailed

resultanyrequired

Responses

200

Successful response

dataActionReceiptrequired

Show properties

idstring<uuid>required

deviceIdstring<uuid>required

capabilitystringrequired

argsobjectrequired

statusstringrequired

Allowed:queuedreceivedsucceededfailedexpiredcancelledunknown

createdAtintegerrequired

expiresAtintegerrequired

dispatchedAtinteger

resultany

clientKeystringrequired

Internal idempotency key stored in the action ledger; included by request/get/result handler responses.

fingerprintstringrequired

Internal canonical request fingerprint; included by request/get/result and action history responses.

principalIdstringrequired

Principal identifier associated with the action.

ownerAuthorizedbooleanrequired

Whether the action was directly authorized by an owner.

400

Invalid request or validation failure

errorobjectrequired

Show properties

codestringrequired

messagestring

issuesobject[]

Show properties

Array of object

pathstring

messagestring

401

Missing or invalid credential

errorobjectrequired

Show properties

codestringrequired

messagestring

issuesobject[]

Show properties

Array of object

pathstring

messagestring

403

Insufficient access or grant

errorobjectrequired

Show properties

codestringrequired

messagestring

issuesobject[]

Show properties

Array of object

pathstring

messagestring

404

Resource not found

errorobjectrequired

Show properties

codestringrequired

messagestring

issuesobject[]

Show properties

Array of object

pathstring

messagestring

413

Request body exceeds the 16 KiB limit

errorobjectrequired

Show properties

codestringrequired

messagestring

issuesobject[]

Show properties

Array of object

pathstring

messagestring

429

Rate limit or workspace capacity limit

errorobjectrequired

Show properties

codestringrequired

messagestring

issuesobject[]

Show properties

Array of object

pathstring

messagestring

500

Internal error

errorobjectrequired

Show properties

codestringrequired

messagestring

issuesobject[]

Show properties

Array of object

pathstring

messagestring

503

Service or required integration is not configured

errorobjectrequired

Show properties

codestringrequired

messagestring

issuesobject[]

Show properties

Array of object

pathstring

messagestring

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

Bearer token (device child credential)Remember on this deviceInclude my values in samples

Parameters

deviceIdpath*x-openlaunch-workspaceheader*Workspace routing identifier for the device credential; not a secret.

Bodyapplication/json

actionIdstring*statusstring*resultstring*

Request

curl -X POST 'https://www.openlaunch.dev/v1/device/497f6eca-6276-4993-bfeb-53cbbbba6f08/result' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'x-openlaunch-workspace: string' \
  -H 'Content-Type: application/json' \
  -d '{
  "actionId": "4a2794ff-94cb-4bac-8d36-d5fb36c563a0",
  "status": "succeeded",
  "result": null
}'

const response: Response = await fetch("https://www.openlaunch.dev/v1/device/497f6eca-6276-4993-bfeb-53cbbbba6f08/result", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "x-openlaunch-workspace": "string",
    "Content-Type": "application/json"
  },
  body: "{\n  \"actionId\": \"4a2794ff-94cb-4bac-8d36-d5fb36c563a0\",\n  \"status\": \"succeeded\",\n  \"result\": null\n}"
});

import requests

response = requests.post(
    "https://www.openlaunch.dev/v1/device/497f6eca-6276-4993-bfeb-53cbbbba6f08/result",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "x-openlaunch-workspace": "string",
        "Content-Type": "application/json"
    },
    data="{\n  \"actionId\": \"4a2794ff-94cb-4bac-8d36-d5fb36c563a0\",\n  \"status\": \"succeeded\",\n  \"result\": null\n}",
)

package main

import (
	"fmt"
	"io"
	"net/http"
	"strings"
)

func main() {
	body := strings.NewReader("{\n  \"actionId\": \"4a2794ff-94cb-4bac-8d36-d5fb36c563a0\",\n  \"status\": \"succeeded\",\n  \"result\": null\n}")
	req, err := http.NewRequest("POST", "https://www.openlaunch.dev/v1/device/497f6eca-6276-4993-bfeb-53cbbbba6f08/result", body)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Authorization", "Bearer YOUR_TOKEN")
	req.Header.Set("x-openlaunch-workspace", "string")
	req.Header.Set("Content-Type", "application/json")

	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()

	data, _ := io.ReadAll(res.Body)
	fmt.Println(string(data))
}

Response

{
  "data": {
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "deviceId": "4de4adb9-21ee-47e3-aeb4-8cf8ed6c109a",
    "capability": "string",
    "args": {},
    "status": "queued",
    "createdAt": 0,
    "expiresAt": 0,
    "dispatchedAt": 0,
    "result": null,
    "clientKey": "string",
    "fingerprint": "string",
    "principalId": "string",
    "ownerAuthorized": true
  }
}

{
  "error": {
    "code": "string",
    "message": "string",
    "issues": [
      {
        "path": "string",
        "message": "string"
      }
    ]
  }
}

{
  "error": {
    "code": "string",
    "message": "string",
    "issues": [
      {
        "path": "string",
        "message": "string"
      }
    ]
  }
}

{
  "error": {
    "code": "string",
    "message": "string",
    "issues": [
      {
        "path": "string",
        "message": "string"
      }
    ]
  }
}

{
  "error": {
    "code": "string",
    "message": "string",
    "issues": [
      {
        "path": "string",
        "message": "string"
      }
    ]
  }
}

{
  "error": {
    "code": "string",
    "message": "string",
    "issues": [
      {
        "path": "string",
        "message": "string"
      }
    ]
  }
}

{
  "error": {
    "code": "string",
    "message": "string",
    "issues": [
      {
        "path": "string",
        "message": "string"
      }
    ]
  }
}

{
  "error": {
    "code": "string",
    "message": "string",
    "issues": [
      {
        "path": "string",
        "message": "string"
      }
    ]
  }
}

{
  "error": {
    "code": "string",
    "message": "string",
    "issues": [
      {
        "path": "string",
        "message": "string"
      }
    ]
  }
}