End a session

DELETE/api/embed/v1/sessions/current

Signs the frame’s session out. The SDK calls it when the frame goes away.

Needs the frame’s session: Authorization: Bearer gri_…. The SDK calls it; you rarely do.

Embed · Self-hosted with an Embed license

Request

It takes no parameters and no body.

Responses

204No Content
Ended.
401UNAUTHORIZED
No session token.
401EMBED_SESSION_ENDED
The session ended. details.reason says why, such as access_removed, role_changed or workspace_deleted.
403EMBED_NOT_AVAILABLE
Embed isn’t licensed here, or sign-in is off (details.reason: not_licensed or sign_in_off).
500INTERNAL_ERROR
Something failed on the installation’s side. Try again.

Any call can also answer: 429 RATE_LIMITED · 503 BUSY. See Errors.

Request

GORUNNER="https://automations.example.com"
GORUNNER_SESSION="gri_…"  # the frame’s session

curl -X DELETE "$GORUNNER/api/embed/v1/sessions/current" \
  -H "Authorization: Bearer $GORUNNER_SESSION"

const GORUNNER = "https://automations.example.com";
const SESSION = process.env.GORUNNER_SESSION; // gri_…

const res = await fetch(
  `${GORUNNER}/api/embed/v1/sessions/current`,
  {
    method: "DELETE",
    headers: {
        Authorization: `Bearer ${SESSION}`,
      },
  },
);
console.log(res.status); // 204

import os, requests

GORUNNER = "https://automations.example.com"
SESSION = os.environ["GORUNNER_SESSION"]  # gri_…

res = requests.delete(
    f"{GORUNNER}/api/embed/v1/sessions/current",
    headers={"Authorization": f"Bearer {SESSION}"},
)
print(res.status_code)  # 204

Response · 204 No Content

http

HTTP/1.1 204 No Content

Every field

It takes no body.

204 No Content: no body.

End a session

Request

Responses

Panel