---
title: "Add Diagram Blocks"
method: POST
path: "/exercise-sessions/{session_id}/exercises/{exercise_id}/blocks/add-diagrams"
tags: ["exercise_sessions"]
---

# Add Diagram Blocks

`POST /exercise-sessions/{session_id}/exercises/{exercise_id}/blocks/add-diagrams`

## Request

- Base URL: `https://api.excellence-ai.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.excellence-ai.com/exercise-sessions/{session_id}/exercises/{exercise_id}/blocks/add-diagrams`
- Auth: OAuth 2 (password, token URL `api/login`)

Add diagram-only blocks (no transcription)
Used for "Ajouter schéma" button

## Path parameters

- `session_id` string, required
- `exercise_id` string, required

## Request body

- AddImagesRequest
  - `image_urls` string[], required

## Response `200`

Successful Response

- SolutionBlockResponse[]
  - `id` string, required
  - `block_type` 'text' | 'image' | 'tableau', required
  - `image_urls` string[], required
  - `diagram_image_urls` string[], required
  - `figure_id` string, nullable
  - `transcribed_text` string, required
  - `transcription_suggestion` string, nullable
  - `position` integer, required
  - `created_at` string, required
  - `updated_at` string, required
  - `tableau` TableauPayload
    - `version` integer
    - `columns` TableauColumn[], required
      - `left_endpoint` string, nullable
      - `right_endpoint` string, nullable
      - `separator_value` string, nullable
      - `label` string, nullable
    - `rows` TableauRow[], required
      - `id` string, required
      - `name` string, required
      - `line_type` 'signes' | 'variations'
    - `cells` object
    - `variable_name` string
  - `etag` string, nullable
  - `ai_generated` boolean
  - `is_correctly_oriented` boolean, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/excellence-ai/apis/excellence-learning.md) - [All operations](https://skmtc.dev/excellence-ai/apis/excellence-learning/llms.txt) - [OpenAPI document](https://skmtc.dev/excellence-ai/apis/excellence-learning/revisions/379e4a57dee8?raw)