---
title: "Create a machine scope"
method: POST
path: "/machines/{machine_id}/scopes"
tags: ["Machines"]
---

# Create a machine scope

`POST /machines/{machine_id}/scopes`

Creates a new machine scope, allowing the specified machine to access another machine.
Maximum of 150 scopes per machine.

## Path parameters

- `machine_id` string, required

## Request body

- object
  - `to_machine_id` string, required — The ID of the machine that will be scoped to the current machine

## Response `200`

Machine scope created successfully for a machine

- MachineScope
  - `object` 'machine_scope', required
  - `from_machine_id` string, required — The ID of the machine that has access to the target machine.
  - `to_machine_id` string, required — The ID of the machine that is being accessed.
  - `created_at` integer, required — Unix timestamp of creation.

## Other responses

- `400` — Request was not successful
- `401` — Authentication invalid
- `403` — Authorization invalid
- `404` — Resource not found
- `409` — Conflict
- `422` — Invalid request parameters

---

[API](https://skmtc.net/clerk/apis/clerk-backend-api.md) · [All operations](https://skmtc.net/clerk/apis/clerk-backend-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/clerk/clerk-backend-api/revisions/75df3a43fcb2/schema)