---
title: "Push status"
method: POST
path: "/orgs/{orgId}/projects/{projectId}/scout/status"
tags: ["Status"]
---

# Push status

`POST /orgs/{orgId}/projects/{projectId}/scout/status`

Scout uses this to periodically report it's status back to main api.

## Path parameters

- `orgId` string, required
- `projectId` string, required

## Headers

- `x-redocly-scout-version` string

## Request body

- Status
  - `hostname` string, required — Hostname of Scout instance.
  - `pid` integer, required — Process ID.
  - `version` string, required — Scout version.
  - `disk` object, required — Disk usage.
    - `size` integer, required — Total disk size.
    - `used` integer, required — Used disk size.
    - `available` integer, required — Available disk size.
    - `unit` 'B' | 'KB' | 'MB' | 'GB' | 'TB', required — Disk size unit.
  - `jobs` object, required — Scout jobs.
    - `active` integer, required — Number of active jobs.
    - `max` integer, required — Maximum number of jobs.

## Response `204`

No content.

## Other responses

- `400` — Bad Request.

---

[API](https://skmtc.net/redocly/apis/redocly-scout.md) · [All operations](https://skmtc.net/redocly/apis/redocly-scout/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/redocly/redocly-scout/versions/193cacd75700/schema)