> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mile.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Brief

> A brief is a reference PDF your field team reads in the mobile app, shared with chosen roles or with every role

## What is Brief?

A brief is a reference PDF, such as an SOP, a product guide or a campaign brief, that your field team reads in the mobile app. It comes from an https link or an uploaded PDF (max 20 MB), and it is shared with chosen roles or with every role. These endpoints are served under `/api/v4`.

**Read briefs** needs no permission and returns only what the caller may see: the owner gets every brief, every other role (admins included) gets the briefs for its own role plus the briefs for every role.

## Key Features

> [card] [Read briefs](https://docs.mile.app/api-reference/flow/brief/read-briefs.md)
>
> GET /briefs

> [card] [Create brief](https://docs.mile.app/api-reference/flow/brief/create-brief.md)
>
> POST /brief

> [card] [Read brief by ID](https://docs.mile.app/api-reference/flow/brief/read-brief-by-id.md)
>
> GET /brief/{id}

> [card] [Update brief](https://docs.mile.app/api-reference/flow/brief/update-brief.md)
>
> PUT /brief/{id}

> [card] [Delete brief](https://docs.mile.app/api-reference/flow/brief/delete-brief.md)
>
> DELETE /brief/{id}


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.