---
title: "Start Scope"
method: POST
path: "/api/projects/scope"
tags: ["scope"]
---

# Start Scope

`POST /api/projects/scope`

Start scoping for a project without creating it.

This endpoint:
1. Streams an initial agent message
2. Runs the scope_project function
3. Streams the scope result

The frontend should connect to Socket.IO and join the scope session room
before calling this endpoint to receive streaming updates.

Args:
    prompt: User's project prompt
    session_id: Session ID for Socket.IO room (client-generated)
    files: Optional file attachments
    user_id: Authenticated user ID
    
Returns:
    ScopeResponse with the scope data

## Response `200`

Successful Response

- ScopeResponse — Response model for scoping endpoint.
  - `success` boolean, required
  - `session_id` string, required
  - `scope` object, nullable
  - `error` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/latted/apis/motion-graphics-designer-api.md) · [All operations](https://skmtc.dev/latted/apis/motion-graphics-designer-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/latted/motion-graphics-designer-api/revisions/36d149b525df/schema)