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

# Reopen an archived project

> The exact inverse of DELETE /projects/{id}: `archivedAt` goes back to null and nothing else moves — archiving destroyed nothing, so the project comes back as it left. Same rights as archiving (company admins and the project's creator). Reopening a project that is not archived is a 409: the project exists and you can see it, it is the gesture that makes no sense.



## OpenAPI

````yaml /api-reference/openapi.json post /projects/{id}/restore
openapi: 3.1.0
info:
  title: Atako API
  version: 0.1.0
  description: >-
    The Atako customer API — manage AI agents, their files, integrations,
    billing, and your company/team, programmatically.


    ## Authentication


    Every non-public endpoint takes a Bearer token that is either:

    - a **programmatic API key** (`aik_…`) — create one at
    [app.atako.ai](https://app.atako.ai) → Settings → API keys (company-admin
    only), or

    - a **Supabase session JWT** — what the web app itself sends; not practical
    to obtain outside a browser session.


    ```bash

    curl https://api.atako.ai/agents -H "Authorization: Bearer aik_..."

    ```


    An API key acts as its owning user, with all of that user's permissions —
    there is no separate key scope in this release.


    ## Other Atako HTTP surfaces (not covered by this spec)


    - **Atako MCP server** — `POST /mcp` (auth: same Bearer token as above)
    exposes a read-only Model Context Protocol tool catalogue for AI clients
    (Claude Code, Claude Desktop, Cursor, ChatGPT). See
    [docs.atako.ai/developers/mcp/overview](https://docs.atako.ai/developers/mcp/overview).

    - **Content API** (`cak_…` key, `/content/*`) — a separate, more restricted
    key type for headless CMS-style access to blog/news/use-case content. Not
    documented here.


    ## Errors


    Errors use a JSON envelope: `{ "error": string, "code"?: string }`. `error`
    is either a short human-readable message or a SCREAMING_SNAKE_CASE code,
    depending on the route — treat it as an opaque string to match against, not
    a stable enum across the whole API.


    ## Rate limits


    Authenticated routes: 6000 requests/min per user (`authRateLimit`). Public
    GET routes: 60/min per IP. A handful of sensitive public POST routes
    (newsletter signup, email-exists, invitation preview) are limited to 10
    requests / 15 min per IP.


    ## Pagination


    List endpoints use either simple `limit`/`offset` query params (marketing
    content — a plain JSON array response, capped at the documented max) or
    `page`/`limit` (credit transactions). Neither returns a total count today;
    fetch until a page comes back shorter than `limit`.
servers:
  - url: https://api.atako.ai
    description: Production
security: []
tags:
  - name: Agents
  - name: Messages
  - name: Activity
  - name: Agent Options
  - name: API Keys
  - name: Files
  - name: Cron Jobs
  - name: Sub-Agents
  - name: Interagent Messages
  - name: Integrations
  - name: Subscriptions
  - name: Users
  - name: Company
  - name: Teams
  - name: Floor
  - name: Projects
  - name: Public
  - name: Marketing Content
paths:
  /projects/{id}/restore:
    post:
      tags:
        - Projects
      summary: Reopen an archived project
      description: >-
        The exact inverse of DELETE /projects/{id}: `archivedAt` goes back to
        null and nothing else moves — archiving destroyed nothing, so the
        project comes back as it left. Same rights as archiving (company admins
        and the project's creator). Reopening a project that is not archived is
        a 409: the project exists and you can see it, it is the gesture that
        makes no sense.
      operationId: restoreProject
      parameters:
        - name: id
          in: path
          required: true
          description: Project id
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: The reopened project.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Project'
        '400':
          description: Malformed project id.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Missing, malformed, or invalid bearer token / API key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: The caller does not have the required role/permission.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Not found, or the caller is not authorized to access this resource.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '409':
          description: NOT_ARCHIVED — the project is already open.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
        - bearerAuth: []
components:
  schemas:
    Project:
      type: object
      description: >-
        A project and everything on it, in one read. A card has no status — its
        state IS the column it stands in — and the wiki is a tree of pages, each
        carrying snapshots of its own past.
      properties:
        id:
          type: string
          format: uuid
        name:
          type: string
        description:
          type: string
        tone:
          $ref: '#/components/schemas/ProjectTone'
        status:
          $ref: '#/components/schemas/ProjectStatus'
        owner:
          type: string
        createdAt:
          type: string
          format: date-time
        updatedAt:
          type: string
          format: date-time
        archivedAt:
          type: string
          format: date-time
          nullable: true
        participants:
          type: array
          items:
            $ref: '#/components/schemas/ProjectParticipant'
        columns:
          type: array
          items:
            $ref: '#/components/schemas/ProjectColumn'
          description: Ordered by position.
        cards:
          type: array
          description: >-
            Non-archived cards, ordered by column then position, each with its
            labels, checklist and comments. The embedded comments carry no `id`
            here (only author/at/text) — the comment operations return the full
            ProjectCardComment.
          items:
            $ref: '#/components/schemas/ProjectCard'
        wiki:
          type: array
          description: >-
            Root pages of the wiki, each carrying its own `children` subtree and
            its `history` (newest revision first).
          items:
            $ref: '#/components/schemas/ProjectWikiPage'
      required:
        - id
        - name
        - description
        - tone
        - status
        - owner
        - createdAt
        - updatedAt
        - archivedAt
        - participants
        - columns
        - cards
        - wiki
    Error:
      type: object
      description: >-
        Atako's standard error envelope. `error` is either a short
        human-readable message or a SCREAMING_SNAKE_CASE code (routes are
        inconsistent about which — treat it as an opaque string and match on it
        exactly if you need to branch on error type). Some routes add extra
        fields alongside `error` (see the operation's own error responses).
      properties:
        error:
          type: string
        code:
          type: string
          description: >-
            Present on some routes; a stable machine-readable code duplicating
            or refining `error`.
      required:
        - error
      additionalProperties: true
    ProjectTone:
      type: string
      enum:
        - amber
        - mint
        - periwinkle
        - plum
        - blush
    ProjectStatus:
      type: string
      enum:
        - active
        - paused
        - done
    ProjectParticipant:
      type: object
      description: >-
        Somebody on the project — a human or an agent, both held the same way so
        a card can be assigned to either. `id` is the project_members row id
        (that is what a card's `assignee` points at), NOT the user/agent id.
        `kind` is derived from the row (agent_id set ⇒ agent), never stored.
      properties:
        id:
          type: string
          format: uuid
        name:
          type: string
        role:
          type: string
          description: >-
            Free text shown on the card ("Chef de projet"…) — unrelated to
            platform permissions.
        kind:
          type: string
          enum:
            - human
            - agent
      required:
        - id
        - name
        - role
        - kind
    ProjectColumn:
      type: object
      description: >-
        One column of a project's board. Columns belong to the project — Atako
        imposes no global set of states — so `kind` is how the rest of the
        interface knows which column means finished without hard-coding a name.
      properties:
        id:
          type: string
          format: uuid
        name:
          type: string
        kind:
          $ref: '#/components/schemas/ProjectColumnKind'
      required:
        - id
        - name
        - kind
    ProjectCard:
      type: object
      description: >-
        A unit of work on the board. It carries no status field: where the card
        stands IS its state, so read `column`. `blocked` and `due` are absent
        rather than null when unset — asking whether a card is blocked is asking
        for the reason.
      properties:
        id:
          type: string
          format: uuid
        title:
          type: string
          maxLength: 500
        description:
          type: string
          maxLength: 20000
        assignee:
          type: string
          format: uuid
          nullable: true
          description: >-
            A ProjectParticipant id (project_members row) — human or agent, both
            assignable — or null when nobody has taken the card.
        column:
          type: string
          format: uuid
          description: 'The column the card stands in: its state.'
        priority:
          $ref: '#/components/schemas/ProjectCardPriority'
        blocked:
          type: string
          maxLength: 500
          description: >-
            Why the card cannot move. Absent when it is not blocked — there is
            no blocked flag, only the reason.
        labels:
          type: array
          items:
            type: string
            maxLength: 40
        createdAt:
          type: string
          format: date-time
        updatedAt:
          type: string
          format: date-time
        due:
          type: string
          format: date-time
          description: Absent when the card has no deadline.
        checklist:
          type: array
          items:
            $ref: '#/components/schemas/ProjectCardChecklistItem'
        comments:
          type: array
          items:
            $ref: '#/components/schemas/ProjectCardComment'
          description: >-
            Oldest first — a discussion is read in the order it was written, not
            like an inbox.
      required:
        - id
        - title
        - description
        - assignee
        - column
        - priority
        - labels
        - createdAt
        - updatedAt
        - checklist
        - comments
    ProjectWikiPage:
      type: object
      description: >-
        A wiki page the way GET /projects/{id} embeds it — the whole tree in one
        read, every page with its full text and its history. The wiki operations
        return the richer ProjectWikiPageDetail instead.
      properties:
        id:
          type: string
          format: uuid
        title:
          type: string
        path:
          type: string
        content:
          type: string
        history:
          type: array
          items:
            $ref: '#/components/schemas/ProjectWikiRevision'
          description: Newest first.
        children:
          type: array
          items:
            $ref: '#/components/schemas/ProjectWikiPage'
      required:
        - id
        - title
        - path
        - content
        - history
        - children
    ProjectColumnKind:
      type: string
      enum:
        - backlog
        - active
        - review
        - done
    ProjectCardPriority:
      type: string
      enum:
        - low
        - normal
        - high
    ProjectCardChecklistItem:
      type: object
      description: >-
        One line of a card's checklist — the small steps a card is made of,
        ticked off without splitting it into more cards.
      properties:
        text:
          type: string
          minLength: 1
          maxLength: 500
        done:
          type: boolean
      required:
        - text
        - done
    ProjectCardComment:
      type: object
      description: >-
        A message on a card — where the discussion that led to a decision stays
        attached to the work it decided. `author` is the display name frozen
        when the comment was written, so someone leaving the company never
        empties the thread behind them. `id` is present on everything the card
        operations return; the copy embedded in GET /projects/{id} carries only
        author/at/text.
      properties:
        id:
          type: string
          format: uuid
        author:
          type: string
        at:
          type: string
          format: date-time
        text:
          type: string
          maxLength: 10000
      required:
        - author
        - at
        - text
    ProjectWikiRevision:
      type: object
      description: >-
        One past state of a page, kept whole rather than as a patch, so reading
        an old version costs a single read. `sha` is a 7-character fingerprint
        unique within the page, and `author` is frozen at write time like a card
        comment's.
      properties:
        id:
          type: string
          format: uuid
        sha:
          type: string
          description: Short content fingerprint, as Git displays one.
        at:
          type: string
          format: date-time
        author:
          type: string
        message:
          type: string
          maxLength: 500
          description: Why the page was written, in the spirit of a commit message.
        content:
          type: string
          description: The page's full Markdown at that moment.
      required:
        - id
        - sha
        - at
        - author
        - message
        - content
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        An `aik_…` programmatic API key (app.atako.ai → Settings → API keys) or
        a Supabase session JWT.

````