{ "openapi": "3.0.1", "info": { "title": "API V1", "version": "v0.3", "description": "A RestFull API for Decidim, to be able to CRUD resources from Decidim. \n_current version: 0.3.4_\n\n## Authentication\n[Get a token](https://octree-gva.github.io/decidim-rest-full/category/authentication) from our `/oauth/token` routes,\nfollowing OAuth specs on Credential Flows or Resource Owner Password Credentials Flow.\n\n### Permissions\nA permission system is attached to the created OAuth application, that is designed in two levels:\n\n- **scope**: a broad permission to access a collection of endpoints\n- **abilities**: a fine grained permission system that allow actions.\n\nThe scopes and abilities are manageable in your System Admin Panel.\n\n### Multi-tenant **Organizations**\nOne deployment hosts many **Organizations** (tenants by **`host`**).\n- The **`system` scope** endpoints apply in the context of the resolved organization\n- The request **`host`** selects which **Organization** you target.\n For example, `example.org/oauth/token` and `foobar.org/oauth/token` obtain tokens for those organizations' OAuth applications.\n\n### Integrators\nStart with the [Integrator quickstart](https://octree-gva.github.io/decidim-rest-full/integrator/quickstart) (host → API client → token → first API call).\n\nTypeScript client: [https://octree-gva.github.io/decidim-rest-full/integrator/typescript-sdk](https://octree-gva.github.io/decidim-rest-full/integrator/typescript-sdk) (`@octree/decidim-sdk`).\n\n**Extended data** (client metadata on organizations, components, spaces, proposals, meetings): [https://octree-gva.github.io/decidim-rest-full/integrator/extended-data](https://octree-gva.github.io/decidim-rest-full/integrator/extended-data).\n\nOutbound **webhook** events are listed under the **Webhooks** tag.\nManage registrations via `/webhook_registrations` (or System admin) and fetch example\npayloads from `GET /webhook_events/{event_type}`.\n" }, "servers": [ { "url": "https://{defaultHost}/api/rest_full/v0.3", "variables": { "defaultHost": { "default": "www.example.org" } } }, { "url": "http://localhost:{port}/api/rest_full/v0.3", "variables": { "port": { "default": "3000" } } } ], "tags": [ { "name": "OAuth", "description": "Obtain access tokens for this API: **client_credentials** (machine-to-machine) or **password** with `auth_type` **login** or **impersonation** (Resource Owner Password Credentials flow).\n* **Machine-to-machine**: client credentials grant\n* **User**: ROPC with `auth_type` **login** or **impersonation**", "externalDocs": { "description": "How to authenticate", "url": "https://octree-gva.github.io/decidim-rest-full/category/authentication" } }, { "name": "Organizations", "description": "**Organization** settings (Decidim tenant boundary: primary `host`, secondary hosts, locale defaults, and related configuration).\n\nOne deployment hosts many **Organizations**. Each organization has:\n\n- `host`: primary domain name\n- `secondary_hosts`: additional hostnames that redirect (301) to `host`\n\nThe active **Organization** is resolved from the request Host header, so different `host` values resolve to that host's organization data.\n" }, { "name": "Organizations Extended Data", "description": "Read organization `extended_data` and merge updates under a dot-path via sync (`PUT /organizations/{id}/extended_data/sync`). Supports recursive merge, dot paths (use `.` for the root), path creation, and clearing keys by setting them to null or empty—see the operation description for full examples. Requires `system` scopes as documented on each operation.\n\nOverview: [Extended data](https://octree-gva.github.io/decidim-rest-full/integrator/extended-data).\n", "externalDocs": { "description": "Extended data integrator guide", "url": "https://octree-gva.github.io/decidim-rest-full/integrator/extended-data" } }, { "name": "Spaces", "description": "Search, list, and fetch participatory spaces (e.g. Assemblies, Participatory Processes).\n\n**Extended data**: `GET/PUT /spaces/{manifest}/{id}/extended_data` (+ `/sync`); filter with `filter[extended_data_cont]` on search and index. See [Extended data](https://octree-gva.github.io/decidim-rest-full/integrator/extended-data).", "externalDocs": { "description": "Extended data integrator guide", "url": "https://octree-gva.github.io/decidim-rest-full/integrator/extended-data" } }, { "name": "Components", "description": "Participatory-space **components** (`Decidim::Component`): modular features (proposals, blogs, meetings, surveys, …) attached to a space.\n\nUse **`GET /components/search`** to discover components by manifest, id, participatory space, or name—within the organization resolved from the request host.\n\nManifest-specific sub-resources (e.g. `proposal_components`, `blog_components`) expose typed settings for that feature.\n\n**Extended data**: `GET/PUT /components/{id}/extended_data` (+ `/sync`); filter with `filter[extended_data_cont]` on search. See [Extended data](https://octree-gva.github.io/decidim-rest-full/integrator/extended-data).", "externalDocs": { "description": "Extended data integrator guide", "url": "https://octree-gva.github.io/decidim-rest-full/integrator/extended-data" } }, { "name": "Users", "description": "List users; read and update your extended data; create and consume magic links for sign-in (scopes and permissions per operation)." }, { "name": "Attachments", "description": "Manage **Decidim::Attachment** rows (files linked to proposals, spaces, etc.).\n\n**Create (mode A):** `POST /attachments` with `multipart/form-data` (`file`, `attached_to_type`, `attached_to_id`, translated `title` / `description`).\n\n**Create (mode B):** `POST /attachments/direct_upload` → use `signed_id` in `POST /attachments` (`application/json`).\n\n**Update:** metadata only (`PUT /attachments/{id}`) — no file replacement in v1.\n\n**List filters:** `filter[attached_to_type]`, `filter[attached_to_id]`, `filter[attachment_collection_id]`, `filter[file_type]` (`image`, `document`, `link`)." }, { "name": "Blogs", "description": "Blog posts (`Decidim::Blogs::Post`) on components with the `:blogs` manifest.\n\n**Visibility** is driven by `published_at`, not a separate published flag:\n- `published_at` is `null` or in the **future** → the post is **not** shown in public index/show (unless you impersonate the author).\n- `published_at` in the **past** → the post is visible to readers with `blogs.read`.\n\n**Read**: `GET /blogs` and `GET /blogs/:id` (conditional caching on GET).\n\n**Write** (`blogs.write`): create and update posts (async by default; `POST /blogs/sync`, `PUT /blogs/:id/sync`). **Delete** (`blogs.destroy`): remove a post (`DELETE /blogs/:id`, async; `DELETE /blogs/:id/sync` inline)." }, { "name": "Forms", "description": "Survey and questionnaire authoring backed by Decidim::Forms.\n\n**Questionnaire** (`Decidim::Forms::Questionnaire`) is the container: title, description, and terms of service. It belongs to a survey resource (e.g. `Decidim::Surveys::Survey`) via `questionnaire_for`.\n\n**Questions** (`Decidim::Forms::Question`) define rows in the questionnaire (`question_type`, `body`, `mandatory`, …). **Answer options** (`Decidim::Forms::AnswerOption`) belong to choice-style questions.\n\n**Participant flow**: answers are submitted as a bundle (`POST /answers` → `submission_requests/:id` for validation state). **Questionnaire responses** (`GET /questionnaire_responses/:id`) expose a read model of stored answers; admins can delete a response bundle.\n\n**Authoring** (credential token, `surveys.questions.manage`): mutate questionnaires, questions, and answer options. Default writes are **async** (`HTTP 202` + `GET /jobs/:uuid`); use `…/sync` routes for inline `200`/`201`.\n\n**Listing**: `GET /questionnaires` returns a JSON Forms projection for rendering; `GET /questions` and `GET /answers` require `filter[questionnaire_id]`." }, { "name": "Meetings", "description": "Published meetings (`Decidim::Meetings::Meeting`) within visible participatory spaces.\n\n**Read** (`meetings.read`): list and show meetings; filter by component, space, and `extended_data`.\n\n**Extended data**: see [Extended data](https://octree-gva.github.io/decidim-rest-full/integrator/extended-data).", "externalDocs": { "description": "Extended data integrator guide", "url": "https://octree-gva.github.io/decidim-rest-full/integrator/extended-data" } }, { "name": "Proposals", "description": "Published proposals (`Decidim::Proposals::Proposal` with `published_at` set) within visible participatory spaces.\n\n**Read** (`proposals.read`): list and show proposals; filter by component, space, scope, and vote-related facets.\n\n**Vote proposals** (`proposals.vote`, impersonation): async `POST /vote_proposals` (202 + job poll) or sync `POST /vote_proposals/sync` (slim vote payload; `?include_proposal=true` for full proposal). One vote per author per proposal.\n\n**Components**: `GET /components/proposal_components` exposes proposals-component settings (votes enabled, limits, phases).\n\nDraft authoring lives under the **Draft Proposals** tag.\n\n**Extended data**: `GET/PUT /proposals/{id}/extended_data` (+ `/sync`); filter with `filter[extended_data_cont]` on index. See [Extended data](https://octree-gva.github.io/decidim-rest-full/integrator/extended-data).", "externalDocs": { "description": "Extended data integrator guide", "url": "https://octree-gva.github.io/decidim-rest-full/integrator/extended-data" } }, { "name": "Draft Proposals", "description": "Unpublished proposals (`published_at` is `null`) tied to your OAuth application and impersonated participant.\n\n**One draft per component**: for a given proposals component and user, only a single draft may exist. Creating again returns `400` if a draft is already present.\n\n**Isolation from the Decidim UI**: drafts created or updated through this API are not editable in the web app, and drafts created in the UI are not visible here.\n\n**Lifecycle**: create → update (`meta.publishable`) → **publish** (`POST /draft_proposals/:id/publish`, async by default; `…/publish/sync` for inline publication) → the resource becomes a published proposal.\n\nRequires **impersonation** token (`proposals.draft`); service (client credentials) tokens cannot hold drafts." }, { "name": "Jobs", "description": "Durable records for **asynchronous API writes** (`decidim_rest_full_api_jobs`).\n\nWhen a mutating route returns **HTTP 202**, the body includes `job_id` (UUID). Poll **`GET /jobs/{id}`** without a Bearer token—the UUID is the capability—or list jobs with the **same OAuth application and resource owner** via **`GET /jobs`** (Bearer required).\n\nFilter the index with `filter[command_key]` (job name, e.g. `draft_proposals#create`) and `filter[status]` (`pending`, `processing`, `completed`, `failed`). Delete a job with **`DELETE /jobs/{id}`** (same OAuth context as the list)." }, { "name": "Roles", "description": "Manage user roles within an organization and its participatory spaces." }, { "name": "Webhooks", "description": "**Outbound HTTP callbacks** plus REST management of registrations.\n\n### Manage registrations\n- `GET|POST /webhook_registrations` — list / create (signing secret returned **only on create**)\n- `GET|PUT|DELETE /webhook_registrations/{id}` — show / update / destroy (scoped to the API client)\n- `GET /webhook_events/{event_type}` — canned example payload for typed clients\n\nSubscribe via this API or in **System admin → API clients → Webhooks**.\n\nVerify deliveries with `X-Webhook-Signature` (`v1=` + HMAC-SHA256 hex of `timestamp + \".\" + raw body`) and `X-Webhook-Timestamp`.\n\nPayload envelope: schema **WebhookDeliveryEnvelope** (discriminated on `type`).\n\n### Event catalog\n\n| Event | Scope | Permission | Payload | Trigger |\n|-------|-------|------------|---------|---------|\n| `draft_proposal_creation.succeeded` | `proposals` | `draft_proposal_creation.succeeded` | `draft_proposal` | Proposal lifecycle notification |\n| `draft_proposal_update.succeeded` | `proposals` | `draft_proposal_update.succeeded` | `draft_proposal` | Proposal lifecycle notification |\n| `meetings.upcoming_reminder.succeeded` | `meetings` | `meetings.upcoming_reminder.succeeded` | — | Upcoming meeting reminder |\n| `participatory_process.step_activated.succeeded` | `public` | `participatory_process.step_activated.succeeded` | `space` | Participatory process step (phase) activated |\n| `proposal_creation.succeeded` | `proposals` | `proposal_creation.succeeded` | `proposal` | Proposal lifecycle notification |\n| `proposal_state_change.succeeded` | `proposals` | `proposal_state_change.succeeded` | `proposal` | Proposal lifecycle notification |\n| `proposal_update.succeeded` | `proposals` | `proposal_update.succeeded` | `proposal` | Proposal lifecycle notification |\n| `system.organizations.created` | `system` | `system.organizations.created` | `organization` | Organization admin change |\n| `system.organizations.deleted` | `system` | `system.organizations.deleted` | `organization` | Organization admin change |\n| `system.organizations.updated` | `system` | `system.organizations.updated` | `organization` | Organization admin change |\n| `user.created` | `oauth` | `user.created` | `user` | User account change |\n| `user.updated` | `oauth` | `user.updated` | `user` | User account change |" } ], "components": { "securitySchemes": { "credentialFlowBearer": { "type": "http", "scheme": "bearer", "bearerFormat": "JWT", "description": "Authorization via service-to-service credentials flow.\nUse this for machine clients.\n[Learn more here](https://octree-gva.github.io/decidim-rest-full/user_documentation/auth/client-credential-flow)\n" }, "resourceOwnerFlowBearer": { "type": "http", "scheme": "bearer", "bearerFormat": "JWT", "description": "Authorization via resource owner flow.\nUse this for user-based authentication\n[Learn more here](https://octree-gva.github.io/decidim-rest-full/user_documentation/auth/user-credentials-flow)\n" } }, "schemas": { "get_action_link": { "title": "GET Action URL", "type": "object", "properties": { "title": { "type": "string", "description": "Action Name" }, "href": { "type": "string", "description": "Full URL" }, "describedby": { "type": "string", "description": "JSONSchema URL describing the request" }, "hreflang": { "type": "array", "items": { "type": "string" }, "description": "Available locales" }, "rel": { "type": "string", "enum": [ "action" ] }, "meta": { "title": "Meta for read request", "type": "object", "properties": { "component_id": { "type": "string", "description": "Component ID" }, "component_manifest": { "type": "string", "description": "Component manifest" }, "space_id": { "type": "string", "description": "Space ID" }, "space_manifest": { "type": "string", "description": "Space Manifest" }, "resource_id": { "type": "string", "description": "Resource ID" }, "action_method": { "type": "string", "enum": [ "GET" ], "description": "Action HTTP method" } }, "required": [ "action_method" ], "additionalProperties": false } }, "required": [ "href", "title", "meta", "rel" ] }, "post_action_link": { "title": "Action URL", "type": "object", "properties": { "title": { "type": "string", "description": "Action Name" }, "href": { "type": "string", "description": "Full URL" }, "describedby": { "type": "string", "description": "JSONSchema URL describing the request" }, "hreflang": { "type": "array", "items": { "type": "string" }, "description": "Available locales" }, "rel": { "type": "string", "enum": [ "action" ] }, "meta": { "title": "Meta for write request", "type": "object", "properties": { "component_id": { "type": "string", "description": "Component ID" }, "component_manifest": { "type": "string", "description": "Component manifest" }, "space_id": { "type": "string", "description": "Space ID" }, "space_manifest": { "type": "string", "description": "Space Manifest" }, "resource_id": { "type": "string", "description": "Resource ID" }, "action_method": { "type": "string", "enum": [ "POST", "DELETE", "PUT" ], "description": "Action HTTP method" }, "action_enctype": { "type": "string", "enum": [ "application/x-www-form-urlencoded", "multipart/form-data" ], "description": "Encoding of the payload" }, "action_target": { "type": "string", "description": "URL to open after submitting a valid request" } }, "required": [ "action_method", "action_enctype" ], "additionalProperties": false } }, "required": [ "href", "title", "meta", "rel" ] }, "resource_link": { "title": "Resource URL", "type": "object", "properties": { "href": { "type": "string", "description": "Full URL" }, "title": { "type": "string", "description": "Page Title" }, "hreflang": { "type": "array", "items": { "type": "string" }, "description": "Available locales" }, "describedby": { "type": "string", "description": "JSONSchema URL describing the request" }, "rel": { "type": "string", "enum": [ "public_page", "resource" ] }, "meta": { "type": "object", "title": "Resource URL Metadata", "properties": { "component_id": { "type": "string", "description": "Component ID" }, "component_manifest": { "type": "string", "description": "Component manifest" }, "space_id": { "type": "string", "description": "Space ID" }, "space_manifest": { "type": "string", "description": "Space Manifest" }, "resource_id": { "type": "string", "description": "Resource ID" } } } }, "required": [ "href", "title", "meta", "rel" ], "additionalProperties": false }, "translated_prop": { "type": "object", "title": "Translated data", "description": "Hash with translated data, key=locale value=translation", "properties": { "en": { "type": "string", "description": "Translation in en" }, "fr": { "type": "string", "description": "Translation in fr" }, "es": { "type": "string", "description": "Translation in es" } }, "additionalProperties": false }, "time_zone": { "type": "string", "title": "Time Zone", "description": "Time Zone identifier", "enum": [ "Africa/Algiers", "Africa/Cairo", "Africa/Casablanca", "Africa/Harare", "Africa/Johannesburg", "Africa/Monrovia", "Africa/Nairobi", "America/Argentina/Buenos_Aires", "America/Asuncion", "America/Bogota", "America/Caracas", "America/Chicago", "America/Chihuahua", "America/Denver", "America/Guatemala", "America/Guyana", "America/Halifax", "America/Indiana/Indianapolis", "America/Juneau", "America/La_Paz", "America/Lima", "America/Lima", "America/Los_Angeles", "America/Mazatlan", "America/Mexico_City", "America/Mexico_City", "America/Monterrey", "America/Montevideo", "America/New_York", "America/Nuuk", "America/Phoenix", "America/Puerto_Rico", "America/Regina", "America/Santiago", "America/Sao_Paulo", "America/St_Johns", "America/Tijuana", "Asia/Almaty", "Asia/Almaty", "Asia/Baghdad", "Asia/Baku", "Asia/Bangkok", "Asia/Bangkok", "Asia/Chongqing", "Asia/Colombo", "Asia/Dhaka", "Asia/Hong_Kong", "Asia/Irkutsk", "Asia/Jakarta", "Asia/Jerusalem", "Asia/Kabul", "Asia/Kamchatka", "Asia/Karachi", "Asia/Karachi", "Asia/Kathmandu", "Asia/Kolkata", "Asia/Kolkata", "Asia/Kolkata", "Asia/Kolkata", "Asia/Krasnoyarsk", "Asia/Kuala_Lumpur", "Asia/Kuwait", "Asia/Magadan", "Asia/Muscat", "Asia/Muscat", "Asia/Novosibirsk", "Asia/Riyadh", "Asia/Seoul", "Asia/Shanghai", "Asia/Singapore", "Asia/Srednekolymsk", "Asia/Taipei", "Asia/Tashkent", "Asia/Tbilisi", "Asia/Tehran", "Asia/Tokyo", "Asia/Tokyo", "Asia/Tokyo", "Asia/Ulaanbaatar", "Asia/Urumqi", "Asia/Vladivostok", "Asia/Yakutsk", "Asia/Yekaterinburg", "Asia/Yerevan", "Atlantic/Azores", "Atlantic/Cape_Verde", "Atlantic/South_Georgia", "Australia/Adelaide", "Australia/Brisbane", "Australia/Canberra", "Australia/Darwin", "Australia/Hobart", "Australia/Melbourne", "Australia/Perth", "Australia/Sydney", "Etc/GMT+12", "Etc/UTC", "Europe/Amsterdam", "Europe/Athens", "Europe/Belgrade", "Europe/Berlin", "Europe/Bratislava", "Europe/Brussels", "Europe/Bucharest", "Europe/Budapest", "Europe/Copenhagen", "Europe/Dublin", "Europe/Helsinki", "Europe/Istanbul", "Europe/Kaliningrad", "Europe/Lisbon", "Europe/Ljubljana", "Europe/London", "Europe/London", "Europe/Madrid", "Europe/Minsk", "Europe/Moscow", "Europe/Moscow", "Europe/Paris", "Europe/Prague", "Europe/Riga", "Europe/Rome", "Europe/Samara", "Europe/Sarajevo", "Europe/Skopje", "Europe/Sofia", "Europe/Stockholm", "Europe/Tallinn", "Europe/Vienna", "Europe/Vilnius", "Europe/Volgograd", "Europe/Warsaw", "Europe/Zagreb", "Europe/Zurich", "Europe/Zurich", "Pacific/Apia", "Pacific/Auckland", "Pacific/Auckland", "Pacific/Chatham", "Pacific/Fakaofo", "Pacific/Fiji", "Pacific/Guadalcanal", "Pacific/Guam", "Pacific/Honolulu", "Pacific/Majuro", "Pacific/Midway", "Pacific/Noumea", "Pacific/Pago_Pago", "Pacific/Port_Moresby", "Pacific/Tongatapu", "UTC" ] }, "component_type": { "type": "string", "enum": [ "page_component", "proposal_component", "meeting_component", "budget_component", "survey_component", "accountability_component", "debate_component", "blog_component", "awesome_map_component", "awesome_iframe_component" ] }, "creation_date": { "title": "Creation date", "description": "Creation date, in ISO8601 format.", "type": "string", "format": "date_time", "example": "2024-11-12T12:34:56Z" }, "edition_date": { "title": "Last Update Date", "description": "Last update date, in ISO8601 format.", "type": "string", "format": "date_time", "example": "2024-12-12T20:34:56Z" }, "publication_date": { "title": "Publication Date", "description": "Publication date, in ISO8601 format.", "type": "string", "format": "date_time", "example": "2024-12-12T20:34:56Z" }, "client_credential": { "type": "object", "title": "Client Credential", "properties": { "grant_type": { "type": "string", "enum": [ "client_credentials" ], "description": "Client Credential Flow, for **machine-to-machine**" }, "client_id": { "type": "string", "description": "OAuth application Client Id" }, "client_secret": { "type": "string", "description": "OAuth application Client Secret" }, "scope": { "type": "string", "enum": [ "public", "spaces", "system", "pages", "oauth", "roles", "attachments", "webhooks" ], "description": "Requested scopes" } }, "required": [ "grant_type", "client_id", "client_secret", "scope" ] }, "password_grant_login": { "type": "object", "title": "Login", "properties": { "grant_type": { "type": "string", "enum": [ "password" ], "description": "Resource Owner Password Credentials (ROPC) Flow, for **user login**" }, "auth_type": { "type": "string", "enum": [ "login" ], "description": "Type of ROPC" }, "username": { "type": "string", "description": "User nickname" }, "password": { "type": "string", "description": "User password" }, "client_id": { "type": "string", "description": "OAuth application Client Id" }, "client_secret": { "type": "string", "description": "OAuth application Client Secret" }, "scope": { "type": "string", "enum": [ "public", "spaces", "pages", "oauth", "roles", "attachments", "webhooks" ], "description": "Request scopes" } }, "required": [ "grant_type", "client_id", "client_secret", "scope", "username", "password", "auth_type" ] }, "password_grant_impersonate": { "type": "object", "title": "Impersonation", "properties": { "grant_type": { "type": "string", "enum": [ "password" ], "description": "Resource Owner Password Credentials (ROPC) Flow, for **user impersonation**" }, "auth_type": { "type": "string", "enum": [ "impersonate" ], "description": "Type of ROPC" }, "username": { "type": "string", "description": "User nickname, unique and at least 6 alphanumeric chars." }, "id": { "type": "string", "description": "User id, will find over id and ignore username. Fails if register_on_missing=true." }, "meta": { "type": "object", "title": "User impersonation settings", "description": "Impersonation Settings", "properties": { "register_on_missing": { "type": "boolean", "description": "Register the user if they do not exist. Default: false" }, "accept_tos_on_register": { "type": "boolean", "description": "Accept the TOS on registration, used only if register_on_missing=true. Default: false" }, "skip_confirmation_on_register": { "type": "boolean", "description": "Skip email confirmation on creation, used only if register_on_missing=true. Default: false" }, "email": { "type": "string", "description": "User email to use on registration. used only if register_on_missing=true. Default to @example.org" }, "name": { "type": "string", "description": "User name. Used only if register_on_missing=true. Default to username" } }, "additionalProperties": false }, "client_id": { "type": "string", "description": "OAuth application Client Id" }, "client_secret": { "type": "string", "description": "OAuth application Client Secret" }, "scope": { "type": "string", "enum": [ "public", "spaces", "pages", "oauth", "roles", "attachments", "webhooks" ], "description": "Request scopes" } }, "additionalProperties": false, "required": [ "grant_type", "client_id", "client_secret", "scope", "auth_type" ] }, "oauth_grant_param": { "oneOf": [ { "$ref": "#/components/schemas/client_credential" }, { "$ref": "#/components/schemas/password_grant_impersonate" }, { "$ref": "#/components/schemas/password_grant_login" } ] }, "password_grant_param": { "oneOf": [ { "$ref": "#/components/schemas/password_grant_impersonate" }, { "$ref": "#/components/schemas/password_grant_login" } ] }, "oauth_token_response": { "type": "object", "title": "OAuth token response", "description": "Doorkeeper access token payload (RFC 6749).", "properties": { "access_token": { "type": "string", "description": "Bearer token value" }, "token_type": { "type": "string", "enum": [ "Bearer" ] }, "expires_in": { "type": "integer", "description": "Lifetime in seconds" }, "scope": { "type": "string", "description": "Granted scopes (space-separated)" }, "created_at": { "type": "integer", "description": "Unix timestamp when the token was issued" } }, "required": [ "access_token", "token_type", "expires_in", "scope", "created_at" ], "additionalProperties": false }, "component_relationship_identifier": { "type": "object", "title": "Component relationship identifier", "description": "JSON:API relationship pointer to a component.", "properties": { "id": { "type": "string", "description": "Component Id" }, "type": { "$ref": "#/components/schemas/component_type" } }, "required": [ "id", "type" ], "additionalProperties": false }, "resource_relationship_identifier": { "type": "object", "title": "Resource relationship identifier", "description": "JSON:API relationship pointer to a component resource (proposal, meeting, etc.).", "properties": { "id": { "type": "string", "description": "Resource Id" }, "type": { "type": "string", "description": "Resource type (e.g. proposals, meetings)" } }, "required": [ "id", "type" ], "additionalProperties": false }, "space_manifest": { "title": "Space Manifest", "description": "Participatory space type key (Decidim manifest name).", "type": "string", "enum": [ "participatory_processes", "assemblies", "conferences", "initiatives" ] }, "component_manifest": { "title": "Component Manifest", "description": "Component type key (Decidim manifest name).", "type": "string", "enum": [ "pages", "proposals", "meetings", "budgets", "surveys", "accountability", "debates", "blogs", "awesome_map", "awesome_iframe" ] }, "resource_manifest": { "title": "Resource Type", "description": "Singular resource type string derived from active component manifests.", "type": "string", "enum": [ "page", "proposal", "meeting", "budget", "survey", "accountability", "debate", "blog", "awesome_map", "awesome_iframe" ] }, "error": { "type": "object", "title": "API error payload", "properties": { "error": { "type": "string", "description": "Summary label; typically includes HTTP status (e.g. `400: Bad request`)." }, "error_description": { "type": "string", "description": "Human-readable detail; for many 4xx responses this is the validation or exception message." }, "state": { "type": "string", "description": "Optional OAuth layer hint present on some token errors (e.g. `unauthorized`)." } }, "additionalProperties": false, "required": [ "error", "error_description" ] }, "error_response": { "$ref": "#/components/schemas/error" }, "health": { "type": "object", "title": "Health Status", "description": "Simple health payload with `message` of `OK` or `ERROR`.", "properties": { "message": { "type": "string", "enum": [ "OK", "ERROR" ], "description": "Overall health flag" } } }, "introspect_data": { "type": "object", "title": "Introspection Response", "properties": { "sub": { "type": "integer", "description": "Access token id" }, "active": { "type": "boolean", "description": "If the token can be used" }, "aud": { "type": "string", "description": "Where this token can be used (organization host)" }, "resource": { "type": "object", "title": "Resource details", "properties": { "id": { "type": "string", "description": "Resource id" }, "type": { "type": "string", "enum": [ "user" ], "description": "Resource type" }, "attributes": { "type": "object", "title": "Resource Attributes", "properties": { "email": { "type": "string", "description": "Email" }, "updated_at": { "type": "string", "description": "Last update date" }, "created_at": { "type": "string", "description": "Creation date" }, "personal_url": { "type": "string", "description": "Personal url (social link, website, etc.)" }, "locale": { "type": "string", "description": "Current preferred locale", "enum": [ "en", "fr", "es" ] } }, "required": [ "email", "created_at", "updated_at" ] } }, "required": [ "id", "type" ] } }, "required": [ "sub", "active", "aud", "exp" ] }, "locale": { "title": "Current locale", "description": "A single locale code configured for this Decidim instance.", "type": "string", "enum": [ "en", "fr", "es" ] }, "locales": { "type": "array", "title": "Available locales", "description": "List of locale codes the organization exposes.", "items": { "$ref": "#/components/schemas/locale" } }, "role_attributes": { "title": "Role Attributes", "type": "object", "properties": { "user_id": { "type": "integer", "description": "ID of the user associated to the role (nullable for pending invitations)" }, "resource_id": { "type": "integer", "description": "ID of the resource (organization or participatory space) the role is attached to" }, "resource_type": { "type": "string", "description": "Type of the resource (e.g. Organization, Decidim::ParticipatoryProcess)" }, "type": { "type": "string", "description": "Kind of role", "enum": [ "general_admin", "space_private_member", "space_administrator", "space_moderator", "space_valuator" ] }, "invited_at": { "type": "string", "format": "date-time", "nullable": true, "description": "Invitation timestamp if the role was created via invitation" }, "accepted_invite": { "type": "boolean", "description": "Whether the invitation has been accepted" }, "created_at": { "$ref": "#/components/schemas/creation_date" }, "updated_at": { "$ref": "#/components/schemas/edition_date" } }, "required": [ "type", "resource_id", "resource_type", "created_at" ], "additionalProperties": false }, "role": { "type": "object", "title": "Role", "properties": { "id": { "type": "string" }, "type": { "type": "string", "enum": [ "role" ] }, "attributes": { "$ref": "#/components/schemas/role_attributes" } }, "required": [ "id", "type", "attributes" ], "additionalProperties": false }, "role_index_response": { "type": "object", "title": "Role Index Response", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/role" } } }, "required": [ "data" ] }, "role_item_response": { "type": "object", "title": "Role Item Response", "properties": { "data": { "$ref": "#/components/schemas/role" } }, "required": [ "data" ] }, "space_type": { "type": "string", "enum": [ "participatory_processes", "assemblies", "conferences", "initiatives" ] }, "space_classes": { "type": "string", "description": "space class name. Part of the polymorphic association (participatory_space_type,participatory_space_id)", "enum": [ "Decidim::ParticipatoryProcess", "Decidim::Assembly", "Decidim::Conference", "Decidim::Initiative" ] }, "space": { "type": "object", "title": "Space", "properties": { "id": { "type": "string", "description": "Space Id" }, "type": { "type": "string", "enum": [ "space" ] }, "attributes": { "title": "Space Attributes", "type": "object", "properties": { "title": { "$ref": "#/components/schemas/translated_prop", "title": "Title translations", "description": "Space title" }, "subtitle": { "$ref": "#/components/schemas/translated_prop", "title": "Subtitle translations", "description": "Space subtitle" }, "short_description": { "$ref": "#/components/schemas/translated_prop", "title": "Short Description translations", "description": "Space short_description" }, "description": { "$ref": "#/components/schemas/translated_prop", "title": "Description translations", "description": "Space description" }, "manifest_name": { "$ref": "#/components/schemas/space_manifest" }, "participatory_space_type": { "type": "string", "example": "Decidim::Assembly" }, "extended_data": { "type": "object", "additionalProperties": true, "description": "Present when the client has public.space.extended_data.read" }, "visibility": { "type": "string", "enum": [ "public", "transparent", "private" ], "description": "Space visibility" }, "created_at": { "$ref": "#/components/schemas/creation_date" }, "updated_at": { "$ref": "#/components/schemas/edition_date" } }, "required": [ "title", "manifest_name", "visibility", "created_at", "updated_at" ], "additionalProperties": false }, "relationships": { "type": "object", "title": "Space relationships", "properties": { "components": { "type": "object", "title": "Space Component Relationships", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/component_relationship_identifier" }, "title": "Space Component Relationships Data" }, "meta": { "title": "Space Component Metadata", "type": "object", "properties": { "count": { "type": "integer", "description": "Total count for components association" } }, "additionalProperties": false, "required": [ "count" ] }, "links": { "type": "object", "title": "Space Component Links", "properties": { "self": { "$ref": "#/components/schemas/resource_link" }, "related": { "$ref": "#/components/schemas/resource_link" } }, "additionalProperties": false, "required": [ "self" ] } }, "required": [ "data", "meta", "links" ] } } }, "links": { "type": "object", "title": "Space Links", "properties": { "self": { "$ref": "#/components/schemas/resource_link" }, "related": { "$ref": "#/components/schemas/resource_link" } }, "required": [ "self", "related" ], "additionalProperties": false } }, "required": [ "id", "type", "attributes", "links", "relationships" ] }, "space_index_response": { "type": "object", "title": "Space Index Response", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/space" } } }, "required": [ "data" ] }, "space_item_response": { "type": "object", "title": "Space Item Response", "properties": { "data": { "$ref": "#/components/schemas/space" } }, "required": [ "data" ] }, "generic_component": { "type": "object", "title": "Component", "properties": { "id": { "type": "string", "description": "Component Id" }, "type": { "$ref": "#/components/schemas/component_type" }, "attributes": { "title": "Component Attributes", "type": "object", "properties": { "name": { "$ref": "#/components/schemas/translated_prop", "description": "Component name" }, "global_announcement": { "$ref": "#/components/schemas/translated_prop", "description": "Component announcement (intro)" }, "participatory_space_type": { "$ref": "#/components/schemas/space_classes" }, "participatory_space_id": { "type": "string", "description": "Associate space id. Part of the polymorphic association (participatory_space_type,participatory_space_id)" }, "created_at": { "$ref": "#/components/schemas/creation_date" }, "updated_at": { "$ref": "#/components/schemas/edition_date" }, "extended_data": { "type": "object", "additionalProperties": true, "description": "Present when the client has public.component.extended_data.read" } }, "required": [ "created_at", "updated_at", "name", "manifest_name", "participatory_space_type", "participatory_space_id" ], "additionalProperties": false }, "meta": { "type": "object", "title": "Component Metadata", "properties": { "published": { "type": "boolean", "description": "Published component?" }, "scopes_enabled": { "type": "boolean", "description": "Component handle scopes?" } }, "additionalProperties": { "oneOf": [ { "type": "boolean" }, { "type": "integer" }, { "type": "string" }, { "$ref": "#/components/schemas/translated_prop" } ] }, "required": [ "published", "scopes_enabled" ] }, "links": { "type": "object", "title": "Component Links", "properties": { "self": { "$ref": "#/components/schemas/resource_link" }, "related": { "$ref": "#/components/schemas/resource_link" } }, "additionalProperties": false, "required": [ "self" ] }, "relationships": { "type": "object", "title": "Component Relationships", "properties": { "resources": { "type": "object", "title": "Component Linked Resources", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/resource_relationship_identifier" }, "title": "Component Linked Resources Data" }, "meta": { "type": "object", "title": "Component Linked Resources Metadata", "properties": { "count": { "type": "integer", "description": "Total count of resources" } }, "required": [ "count" ] } }, "required": [ "data", "meta" ] } } } } }, "organization_attributes": { "title": "Organization Attributes", "type": "object", "properties": { "name": { "$ref": "#/components/schemas/translated_prop", "additionalProperties": { "type": "string" } }, "description": { "$ref": "#/components/schemas/translated_prop", "additionalProperties": { "type": "string" } }, "reference_prefix": { "type": "string", "description": "Prefix for the organization. Used to prefix uploaded files and reference resources" }, "host": { "type": "string" }, "send_welcome_notification": { "type": "boolean", "description": "True if welcome email is sent to users" }, "secondary_hosts": { "type": "array", "items": { "type": "string", "description": "Additional host, will redirect (301) to `host`" } }, "available_locales": { "type": "array", "title": "Available locales", "description": "List of locale codes the organization exposes.", "items": { "$ref": "#/components/schemas/locale" } }, "default_locale": { "type": "string", "description": "Default locale for the organization" }, "users_registration_mode": { "type": "string", "enum": [ "enabled", "existing", "disabled" ], "description": "Define user registration mode: \n- `enabled`: Enable users registration\n- `existing`: Existing users will be able to login. Registration will be disabled.\n- `disabled`: No registration enabled\n" }, "force_users_to_authenticate_before_access_organization": { "type": "boolean", "description": "Force users to authenticate before accessing the organization (disabled if users_registration_mode is `disabled`)" }, "badges_enabled": { "type": "boolean", "description": "Enable badges for public views" }, "enable_participatory_space_filters": { "type": "boolean", "description": "Display areas and scopes filter in public views." }, "enable_machine_translations": { "type": "boolean", "description": "Enable machine translations (must be configured, see [Using machine translations](https://docs.decidim.org/en/develop/develop/machine_translations.html))" }, "user_groups_enabled": { "type": "boolean", "description": "Enable user groups in public views" }, "time_zone": { "$ref": "#/components/schemas/time_zone" }, "comments_max_length": { "type": "integer", "description": "Default maximum length of comments" }, "rich_text_editor_in_public_views": { "type": "boolean", "description": "Enable rich text editor in public views" }, "created_at": { "$ref": "#/components/schemas/creation_date" }, "updated_at": { "$ref": "#/components/schemas/edition_date" }, "extended_data": { "type": "object", "title": "Extended data for the organization" } }, "additionalProperties": false, "required": [ "host", "name", "available_locales", "default_locale" ] }, "organization": { "type": "object", "title": "Organization", "properties": { "id": { "type": "string" }, "type": { "type": "string", "enum": [ "organization" ] }, "attributes": { "$ref": "#/components/schemas/organization_attributes" }, "meta": { "title": "Organization Metadata", "type": "object", "properties": { "locales": { "type": "array", "title": "Available locales", "description": "List of locale codes the organization exposes.", "items": { "$ref": "#/components/schemas/locale" } }, "unconfirmed_host": { "type": "string", "description": "If host update is pending, unconfirmed host for the organization" } }, "required": [ "locales" ], "additionalProperties": false } }, "required": [ "id", "type", "attributes", "meta" ] }, "organization_index_response": { "type": "object", "title": "Organization Index Response", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/organization" } } }, "required": [ "data" ] }, "organization_item_response": { "type": "object", "title": "Organization Item Response", "properties": { "data": { "$ref": "#/components/schemas/organization" } }, "required": [ "data" ] }, "organization_extended_data": { "type": "object", "title": "Organization extended data", "properties": { "data": { "description": "Value at object_path (object, array, string, number, boolean, or null)." } }, "required": [ "data" ], "additionalProperties": true, "description": "Client metadata hash on an organization (`HasExtendedData`).\nSee [Extended data](https://octree-gva.github.io/decidim-rest-full/integrator/extended-data).\n" }, "resource_extended_data": { "type": "object", "title": "Resource extended data", "properties": { "data": { "description": "Value at the requested object_path (`.` for the full hash)." } }, "required": [ "data" ], "additionalProperties": false, "description": "Client metadata hash on a Decidim resource (`HasExtendedData`).\nKept out of the Decidim admin UI.\nSee [Extended data](https://octree-gva.github.io/decidim-rest-full/integrator/extended-data).\n" }, "user_extended_data": { "type": "object", "title": "User extended data", "properties": {}, "additionalProperties": true, "description": "Client metadata hash on the current user. Kept out of the Decidim admin UI.\nSee [Extended data](https://octree-gva.github.io/decidim-rest-full/integrator/extended-data) (user path: `/me/extended_data`).\n" }, "user": { "type": "object", "title": "User", "properties": { "id": { "type": "string" }, "type": { "type": "string", "enum": [ "user" ] }, "meta": { "title": "User Metadata", "type": "object", "properties": { "blocked": { "type": "boolean", "description": "If the user is blocked, and need to be unblocked to signin" }, "locked": { "type": "boolean", "description": "If the user is locked, and need to click on the mail link to unlock" } }, "required": [ "blocked", "locked" ], "additionalProperties": false }, "relationships": { "type": "object", "title": "User Relationships", "properties": { "roles": { "type": "object", "title": "User Roles", "properties": { "data": { "type": "array", "items": { "type": "object", "title": "User Role", "properties": { "id": { "type": "string" }, "type": { "type": "string", "enum": [ "user_role" ] } }, "required": [ "id", "type" ], "additionalProperties": false } } }, "required": [ "data" ], "additionalProperties": false } } }, "attributes": { "type": "object", "title": "User Attributes", "properties": { "name": { "description": "User name, use to display the Profile identity. Public", "type": "string" }, "nickname": { "description": "User nickname, unique identifier for the user. Public", "type": "string" }, "personal_url": { "description": "Personal website URL or social link. Public", "type": "string" }, "about": { "description": "Short bio of the user. Public", "type": "string" }, "locale": { "$ref": "#/components/schemas/locale", "description": "User locale. Fallback to default locale of the organization. Private" }, "email": { "description": "Email of the user. Private", "type": "string" }, "extended_data": { "type": "object", "title": "User Extended Data", "description": "Additional data. Private", "properties": {}, "additionalProperties": true }, "created_at": { "$ref": "#/components/schemas/creation_date" }, "updated_at": { "$ref": "#/components/schemas/edition_date" } }, "additionalProperties": false, "required": [ "created_at", "updated_at", "name", "nickname", "locale", "extended_data" ] } }, "required": [ "id", "type", "attributes" ], "additionalProperties": false }, "user_index_response": { "type": "object", "title": "User Index Response", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/user" } } }, "required": [ "data" ] }, "user_item_response": { "type": "object", "title": "User Item Response", "properties": { "data": { "$ref": "#/components/schemas/user" } }, "required": [ "data" ] }, "magic_link": { "type": "object", "title": "Magic Link", "properties": { "id": { "type": "string", "description": "Magic Token ID" }, "type": { "type": "string", "enum": [ "magic_link" ] }, "attributes": { "type": "object", "title": "Magic Link Attributes", "properties": { "token": { "type": "string", "description": "Magic Link Token" }, "label": { "type": "string", "description": "Magic Link description" }, "redirect_url": { "type": "string", "nullable": true, "description": "If set at create time, the GET sign-in flow redirects here after successful sign-in (HTTPS, allowlisted host)" } }, "required": [ "token", "label" ] }, "links": { "type": "object", "title": "Magic Link links", "properties": { "self": { "$ref": "#/components/schemas/resource_link" }, "sign_in": { "$ref": "#/components/schemas/resource_link" } }, "required": [ "self", "sign_in" ] } }, "required": [ "attributes", "links", "id", "type" ], "additionalProperties": false }, "magic_link_index_response": { "type": "object", "title": "Magic Link Index Response", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/magic_link" } } }, "required": [ "data" ] }, "magic_link_item_response": { "type": "object", "title": "Magic Link Item Response", "properties": { "data": { "$ref": "#/components/schemas/magic_link" } }, "required": [ "data" ] }, "magic_link_redirect": { "type": "object", "title": "Magic Redirect", "properties": { "id": { "type": "string", "description": "Magic Token ID" }, "type": { "type": "string", "enum": [ "magic_link_redirect" ] }, "attributes": { "type": "object", "title": "Magic Link Attributes", "properties": { "redirect_url": { "type": "string", "description": "Redirection destination" }, "label": { "type": "string", "description": "Magic Link description" } }, "required": [ "redirect_url", "label" ] }, "links": { "type": "object", "title": "Magic Link links", "properties": { "self": { "$ref": "#/components/schemas/get_action_link" }, "magic_link": { "$ref": "#/components/schemas/get_action_link" } }, "required": [ "self", "magic_link" ] } }, "required": [ "attributes", "links", "id", "type" ], "additionalProperties": false }, "rest_full_hypermedia_link": { "title": "Hypermedia link", "type": "object", "properties": { "href": { "type": "string", "description": "Target URL" }, "title": { "type": "string" }, "rel": { "type": "string" }, "meta": { "type": "object", "properties": { "action_method": { "type": "string", "description": "HTTP method for the link target" } }, "additionalProperties": true } }, "required": [ "href", "rel" ], "additionalProperties": false }, "rest_full_api_job_links": { "title": "API job hypermedia controls", "type": "object", "properties": { "self": { "$ref": "#/components/schemas/rest_full_hypermedia_link" } }, "required": [ "self" ], "additionalProperties": false }, "rest_full_api_job_summary": { "title": "API job summary", "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "description": "Job identifier; use with GET /jobs/{id}" }, "status": { "type": "string", "enum": [ "pending", "processing", "completed", "failed" ], "description": "Lifecycle state" }, "command_key": { "type": "string", "description": "Async handler key registered by the REST extension" }, "created_at": { "type": "string", "format": "date-time" }, "updated_at": { "type": "string", "format": "date-time" }, "links": { "$ref": "#/components/schemas/rest_full_api_job_links" } }, "required": [ "id", "status", "command_key", "created_at", "updated_at", "links" ], "additionalProperties": false }, "rest_full_api_job_detail": { "title": "API job", "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "description": "Job identifier from the HTTP 202 body" }, "status": { "type": "string", "enum": [ "pending", "processing", "completed", "failed" ] }, "command_key": { "type": "string" }, "created_at": { "type": "string", "format": "date-time" }, "updated_at": { "type": "string", "format": "date-time" }, "error_class": { "type": "string", "nullable": true }, "error_message": { "type": "string", "nullable": true }, "data": { "nullable": true, "description": "Success payload embedded from the worker (shape depends on command_key)" }, "return_value": { "nullable": true, "description": "Alias retained for backwards compatibility when present" }, "links": { "$ref": "#/components/schemas/rest_full_api_job_links" } }, "required": [ "id", "status", "command_key", "created_at", "updated_at", "links" ], "additionalProperties": true }, "rest_full_api_jobs_index_response": { "title": "API jobs index payload", "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/rest_full_api_job_summary" } }, "meta": { "type": "object", "properties": { "page": { "type": "integer" }, "per_page": { "type": "integer" } }, "required": [ "page", "per_page" ], "additionalProperties": false } }, "required": [ "data", "meta" ], "additionalProperties": false }, "rest_full_api_job_accepted": { "title": "HTTP 202 async job envelope", "type": "object", "properties": { "job_id": { "type": "string", "format": "uuid" }, "status": { "type": "string", "enum": [ "pending" ] }, "data": { "nullable": true }, "return_value": { "nullable": true }, "poll_url": { "type": "string", "description": "Absolute URL for GET /jobs/{job_id}; duplicate of links.self.href for flat JSON clients" }, "links": { "$ref": "#/components/schemas/rest_full_api_job_links" } }, "required": [ "job_id", "status", "data", "return_value", "poll_url", "links" ], "additionalProperties": false }, "attachment_attached_to": { "title": "Attachment parent reference", "type": "object", "properties": { "type": { "type": "string", "description": "Polymorphic type (e.g. Decidim::Proposals::Proposal)" }, "id": { "type": "integer" } }, "required": [ "type", "id" ], "additionalProperties": false }, "attachment_attributes": { "title": "Attachment attributes", "type": "object", "properties": { "title": { "$ref": "#/components/schemas/translated_prop" }, "description": { "$ref": "#/components/schemas/translated_prop" }, "weight": { "type": "integer" }, "attachment_collection_id": { "type": "integer", "nullable": true }, "file_type": { "type": "string", "enum": [ "image", "document", "link" ] }, "content_type": { "type": "string", "nullable": true }, "url": { "type": "string", "nullable": true, "description": "Public URL when file is attached" }, "thumbnail_url": { "type": "string", "nullable": true }, "attached_to": { "$ref": "#/components/schemas/attachment_attached_to" }, "created_at": { "$ref": "#/components/schemas/creation_date" }, "updated_at": { "$ref": "#/components/schemas/edition_date" } }, "required": [ "title", "attached_to", "created_at" ], "additionalProperties": false }, "attachment": { "type": "object", "title": "Attachment", "properties": { "id": { "type": "string" }, "type": { "type": "string", "enum": [ "attachment" ] }, "attributes": { "$ref": "#/components/schemas/attachment_attributes" } }, "required": [ "id", "type", "attributes" ], "additionalProperties": false }, "attachment_index_response": { "type": "object", "title": "Attachment Index Response", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/attachment" } } }, "required": [ "data" ] }, "attachment_item_response": { "type": "object", "title": "Attachment Item Response", "properties": { "data": { "$ref": "#/components/schemas/attachment" } }, "required": [ "data" ] }, "attachment_direct_upload_response": { "type": "object", "properties": { "signed_id": { "type": "string" }, "filename": { "type": "string" }, "content_type": { "type": "string" }, "byte_size": { "type": "integer" } }, "required": [ "signed_id", "filename", "content_type", "byte_size" ], "additionalProperties": false }, "webhook_registration_attributes": { "title": "Webhook Registration Attributes", "type": "object", "properties": { "url": { "type": "string", "format": "uri", "description": "HTTPS callback URL" }, "subscriptions": { "type": "array", "items": { "type": "string" }, "description": "Event keys this registration receives" }, "signing_secret": { "type": "string", "description": "HMAC signing secret (returned only on create)" }, "created_at": { "$ref": "#/components/schemas/creation_date" }, "updated_at": { "$ref": "#/components/schemas/edition_date" } }, "required": [ "url", "subscriptions", "created_at", "updated_at" ], "additionalProperties": false }, "webhook_registration_create_attributes": { "title": "Webhook Registration Create Attributes", "type": "object", "properties": { "url": { "type": "string", "format": "uri", "description": "HTTPS callback URL" }, "subscriptions": { "type": "array", "items": { "type": "string" }, "minItems": 1, "description": "Event keys to subscribe (must be granted as event permissions on the API client)" } }, "required": [ "url", "subscriptions" ], "additionalProperties": false }, "webhook_registration_create_body": { "title": "Webhook Registration Create Body", "type": "object", "properties": { "data": { "type": "object", "properties": { "attributes": { "$ref": "#/components/schemas/webhook_registration_create_attributes" } }, "required": [ "attributes" ] } }, "required": [ "data" ], "additionalProperties": false }, "webhook_registration": { "type": "object", "title": "Webhook Registration", "properties": { "id": { "type": "string" }, "type": { "type": "string", "enum": [ "webhook_registration" ] }, "attributes": { "$ref": "#/components/schemas/webhook_registration_attributes" } }, "required": [ "id", "type", "attributes" ], "additionalProperties": false }, "webhook_registration_index_response": { "type": "object", "title": "Webhook Registration Index Response", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/webhook_registration" } } }, "required": [ "data" ] }, "webhook_registration_item_response": { "type": "object", "title": "Webhook Registration Item Response", "properties": { "data": { "$ref": "#/components/schemas/webhook_registration" } }, "required": [ "data" ] }, "accountability_component": { "type": "object", "title": "Accountability component", "properties": { "id": { "type": "string", "description": "Accountability component Id" }, "type": { "type": "string", "enum": [ "accountability_component" ] }, "attributes": { "title": "Accountability component Attributes", "type": "object", "properties": { "name": { "$ref": "#/components/schemas/translated_prop", "description": "Accountability component name" }, "global_announcement": { "$ref": "#/components/schemas/translated_prop", "description": "Accountability component announcement (intro)" }, "participatory_space_type": { "$ref": "#/components/schemas/space_classes" }, "participatory_space_id": { "type": "string", "description": "Associate space id. Part of the polymorphic association (participatory_space_type,participatory_space_id)" }, "created_at": { "$ref": "#/components/schemas/creation_date" }, "updated_at": { "$ref": "#/components/schemas/edition_date" }, "extended_data": { "type": "object", "additionalProperties": true, "description": "Present when the client has public.component.extended_data.read" }, "manifest_name": { "type": "string", "enum": [ "accountability" ] } }, "required": [ "created_at", "updated_at", "name", "manifest_name", "participatory_space_type", "participatory_space_id" ], "additionalProperties": false }, "meta": { "type": "object", "title": "Accountability component Metadata", "properties": { "published": { "type": "boolean", "description": "Published component?" }, "scopes_enabled": { "type": "boolean", "description": "Accountability component handle scopes?" } }, "additionalProperties": { "oneOf": [ { "type": "boolean" }, { "type": "integer" }, { "type": "string" }, { "$ref": "#/components/schemas/translated_prop" } ] }, "required": [ "published", "scopes_enabled" ] }, "links": { "type": "object", "title": "Accountability component Links", "properties": { "self": { "$ref": "#/components/schemas/resource_link" }, "related": { "$ref": "#/components/schemas/resource_link" } }, "additionalProperties": false, "required": [ "self" ] }, "relationships": { "type": "object", "title": "Accountability component Relationships", "properties": { "resources": { "type": "object", "title": "Accountability component Linked Resources", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/resource_relationship_identifier" }, "title": "Accountability component Linked Resources Data" }, "meta": { "type": "object", "title": "Accountability component Linked Resources Metadata", "properties": { "count": { "type": "integer", "description": "Total count of resources" } }, "required": [ "count" ] } }, "required": [ "data", "meta" ] } } } } }, "accountability_component_index_response": { "type": "object", "title": "Accountability Component Index Response", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/accountability_component" } } }, "required": [ "data" ] }, "accountability_component_item_response": { "type": "object", "title": "Accountability Component Item Response", "properties": { "data": { "$ref": "#/components/schemas/accountability_component" } }, "required": [ "data" ] }, "blog_component": { "type": "object", "title": "Blogs component", "properties": { "id": { "type": "string", "description": "Blogs component Id" }, "type": { "type": "string", "enum": [ "blog_component" ] }, "attributes": { "title": "Blogs component Attributes", "type": "object", "properties": { "name": { "$ref": "#/components/schemas/translated_prop", "description": "Blogs component name" }, "global_announcement": { "$ref": "#/components/schemas/translated_prop", "description": "Blogs component announcement (intro)" }, "participatory_space_type": { "$ref": "#/components/schemas/space_classes" }, "participatory_space_id": { "type": "string", "description": "Associate space id. Part of the polymorphic association (participatory_space_type,participatory_space_id)" }, "created_at": { "$ref": "#/components/schemas/creation_date" }, "updated_at": { "$ref": "#/components/schemas/edition_date" }, "extended_data": { "type": "object", "additionalProperties": true, "description": "Present when the client has public.component.extended_data.read" }, "manifest_name": { "type": "string", "enum": [ "blogs" ] } }, "required": [ "created_at", "updated_at", "name", "manifest_name", "participatory_space_type", "participatory_space_id" ], "additionalProperties": false }, "meta": { "type": "object", "title": "Blogs component Metadata", "properties": { "published": { "type": "boolean", "description": "Published component?" }, "scopes_enabled": { "type": "boolean", "description": "Blogs component handle scopes?" } }, "additionalProperties": { "oneOf": [ { "type": "boolean" }, { "type": "integer" }, { "type": "string" }, { "$ref": "#/components/schemas/translated_prop" } ] }, "required": [ "published", "scopes_enabled" ] }, "links": { "type": "object", "title": "Blogs component Links", "properties": { "self": { "$ref": "#/components/schemas/resource_link" }, "related": { "$ref": "#/components/schemas/resource_link" } }, "additionalProperties": false, "required": [ "self" ] }, "relationships": { "type": "object", "title": "Blogs component Relationships", "properties": { "resources": { "type": "object", "title": "Blogs component Linked Resources", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/resource_relationship_identifier" }, "title": "Blogs component Linked Resources Data" }, "meta": { "type": "object", "title": "Blogs component Linked Resources Metadata", "properties": { "count": { "type": "integer", "description": "Total count of resources" } }, "required": [ "count" ] } }, "required": [ "data", "meta" ] } } } } }, "blog_component_index_response": { "type": "object", "title": "Blog Component Index Response", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/blog_component" } } }, "required": [ "data" ] }, "blog_component_item_response": { "type": "object", "title": "Blog Component Item Response", "properties": { "data": { "$ref": "#/components/schemas/blog_component" } }, "required": [ "data" ] }, "blog": { "type": "object", "title": "Post", "properties": { "id": { "type": "string", "description": "Post id (Blogs::Post)" }, "type": { "type": "string", "enum": [ "blog" ], "description": "JSON:API type discriminator for this resource" }, "attributes": { "type": "object", "title": "Post attributes", "properties": { "title": { "$ref": "#/components/schemas/translated_prop" }, "body": { "$ref": "#/components/schemas/translated_prop" }, "created_at": { "$ref": "#/components/schemas/creation_date" }, "updated_at": { "$ref": "#/components/schemas/edition_date" }, "published_at": { "$ref": "#/components/schemas/publication_date" } }, "required": [ "created_at", "updated_at", "title", "body" ], "additionalProperties": false }, "meta": { "type": "object", "title": "Post metadata", "properties": { "published": { "type": "boolean", "description": "Whether the post is published" }, "scope": { "type": "integer", "description": "Scope id (component or participatory space scope)" } }, "additionalProperties": { "oneOf": [ { "type": "boolean" }, { "type": "integer" }, { "type": "string" }, { "$ref": "#/components/schemas/translated_prop" } ] }, "required": [ "published" ] }, "links": { "type": "object", "title": "Post links", "properties": { "self": { "$ref": "#/components/schemas/resource_link" }, "collection": { "$ref": "#/components/schemas/resource_link" }, "related": { "$ref": "#/components/schemas/resource_link" }, "prev": { "$ref": "#/components/schemas/resource_link" }, "next": { "$ref": "#/components/schemas/resource_link" } }, "additionalProperties": false, "required": [ "self", "collection", "related" ] }, "relationships": { "type": "object", "title": "Post relationships", "properties": { "space": { "title": "Linked participatory space", "type": "object", "properties": { "data": { "type": "object", "title": "Linked participatory space Data", "properties": { "id": { "type": "string", "description": "Resource Id" }, "type": { "type": "string", "enum": [ "participatory_processes", "assemblies", "conferences", "initiatives" ] } }, "required": [ "id", "type" ] } }, "required": [ "data" ] }, "component": { "title": "Linked blogs component", "type": "object", "properties": { "data": { "type": "object", "title": "Linked blogs component Data", "properties": { "id": { "type": "string", "description": "Resource Id" }, "type": { "type": "string", "enum": [ "blog_component" ] } }, "required": [ "id", "type" ] } }, "required": [ "data" ] } }, "required": [ "component", "space" ], "additionalProperties": false } }, "required": [ "id", "type", "attributes", "meta", "links" ] }, "blog_index_response": { "type": "object", "title": "Blog Index Response", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/blog" } } }, "required": [ "data" ] }, "blog_item_response": { "type": "object", "title": "Blog Item Response", "properties": { "data": { "$ref": "#/components/schemas/blog" } }, "required": [ "data" ] }, "blog_post_create_payload": { "type": "object", "title": "Blog post create payload", "required": [ "data" ], "properties": { "data": { "type": "object", "required": [ "component_id", "attributes" ], "properties": { "component_id": { "type": "integer", "description": "Blogs component id" }, "attributes": { "type": "object", "required": [ "title", "body" ], "properties": { "title": { "$ref": "#/components/schemas/translated_prop" }, "body": { "$ref": "#/components/schemas/translated_prop" }, "published_at": { "type": "string", "format": "date-time", "nullable": true, "description": "ISO8601; omit or null for draft" } }, "additionalProperties": false } }, "additionalProperties": false } }, "additionalProperties": false }, "budget_component": { "type": "object", "title": "Budget component", "properties": { "id": { "type": "string", "description": "Budget component Id" }, "type": { "type": "string", "enum": [ "budget_component" ] }, "attributes": { "title": "Budget component Attributes", "type": "object", "properties": { "name": { "$ref": "#/components/schemas/translated_prop", "description": "Budget component name" }, "global_announcement": { "$ref": "#/components/schemas/translated_prop", "description": "Budget component announcement (intro)" }, "participatory_space_type": { "$ref": "#/components/schemas/space_classes" }, "participatory_space_id": { "type": "string", "description": "Associate space id. Part of the polymorphic association (participatory_space_type,participatory_space_id)" }, "created_at": { "$ref": "#/components/schemas/creation_date" }, "updated_at": { "$ref": "#/components/schemas/edition_date" }, "extended_data": { "type": "object", "additionalProperties": true, "description": "Present when the client has public.component.extended_data.read" }, "manifest_name": { "type": "string", "enum": [ "budgets" ] } }, "required": [ "created_at", "updated_at", "name", "manifest_name", "participatory_space_type", "participatory_space_id" ], "additionalProperties": false }, "meta": { "type": "object", "title": "Budget component Metadata", "properties": { "published": { "type": "boolean", "description": "Published component?" }, "scopes_enabled": { "type": "boolean", "description": "Budget component handle scopes?" } }, "additionalProperties": { "oneOf": [ { "type": "boolean" }, { "type": "integer" }, { "type": "string" }, { "$ref": "#/components/schemas/translated_prop" } ] }, "required": [ "published", "scopes_enabled" ] }, "links": { "type": "object", "title": "Budget component Links", "properties": { "self": { "$ref": "#/components/schemas/resource_link" }, "related": { "$ref": "#/components/schemas/resource_link" } }, "additionalProperties": false, "required": [ "self" ] }, "relationships": { "type": "object", "title": "Budget component Relationships", "properties": { "resources": { "type": "object", "title": "Budget component Linked Resources", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/resource_relationship_identifier" }, "title": "Budget component Linked Resources Data" }, "meta": { "type": "object", "title": "Budget component Linked Resources Metadata", "properties": { "count": { "type": "integer", "description": "Total count of resources" } }, "required": [ "count" ] } }, "required": [ "data", "meta" ] } } } } }, "budget_component_index_response": { "type": "object", "title": "Budget Component Index Response", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/budget_component" } } }, "required": [ "data" ] }, "budget_component_item_response": { "type": "object", "title": "Budget Component Item Response", "properties": { "data": { "$ref": "#/components/schemas/budget_component" } }, "required": [ "data" ] }, "debate_component": { "type": "object", "title": "Debates component", "properties": { "id": { "type": "string", "description": "Debates component Id" }, "type": { "type": "string", "enum": [ "debate_component" ] }, "attributes": { "title": "Debates component Attributes", "type": "object", "properties": { "name": { "$ref": "#/components/schemas/translated_prop", "description": "Debates component name" }, "global_announcement": { "$ref": "#/components/schemas/translated_prop", "description": "Debates component announcement (intro)" }, "participatory_space_type": { "$ref": "#/components/schemas/space_classes" }, "participatory_space_id": { "type": "string", "description": "Associate space id. Part of the polymorphic association (participatory_space_type,participatory_space_id)" }, "created_at": { "$ref": "#/components/schemas/creation_date" }, "updated_at": { "$ref": "#/components/schemas/edition_date" }, "extended_data": { "type": "object", "additionalProperties": true, "description": "Present when the client has public.component.extended_data.read" }, "manifest_name": { "type": "string", "enum": [ "debates" ] } }, "required": [ "created_at", "updated_at", "name", "manifest_name", "participatory_space_type", "participatory_space_id" ], "additionalProperties": false }, "meta": { "type": "object", "title": "Debates component Metadata", "properties": { "published": { "type": "boolean", "description": "Published component?" }, "scopes_enabled": { "type": "boolean", "description": "Debates component handle scopes?" } }, "additionalProperties": { "oneOf": [ { "type": "boolean" }, { "type": "integer" }, { "type": "string" }, { "$ref": "#/components/schemas/translated_prop" } ] }, "required": [ "published", "scopes_enabled" ] }, "links": { "type": "object", "title": "Debates component Links", "properties": { "self": { "$ref": "#/components/schemas/resource_link" }, "related": { "$ref": "#/components/schemas/resource_link" } }, "additionalProperties": false, "required": [ "self" ] }, "relationships": { "type": "object", "title": "Debates component Relationships", "properties": { "resources": { "type": "object", "title": "Debates component Linked Resources", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/resource_relationship_identifier" }, "title": "Debates component Linked Resources Data" }, "meta": { "type": "object", "title": "Debates component Linked Resources Metadata", "properties": { "count": { "type": "integer", "description": "Total count of resources" } }, "required": [ "count" ] } }, "required": [ "data", "meta" ] } } } } }, "debate_component_index_response": { "type": "object", "title": "Debate Component Index Response", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/debate_component" } } }, "required": [ "data" ] }, "debate_component_item_response": { "type": "object", "title": "Debate Component Item Response", "properties": { "data": { "$ref": "#/components/schemas/debate_component" } }, "required": [ "data" ] }, "forms_locale_meta": { "type": "object", "title": "Forms locale metadata", "properties": { "locale": { "type": "string", "description": "Effective locale for projected strings" }, "requested_locale": { "type": "string", "description": "Client-requested locale before fallback" }, "fallback_from": { "type": "string", "nullable": true, "description": "Locale downgraded from, if any" } }, "required": [ "locale", "requested_locale" ], "additionalProperties": false }, "forms_submission_policy_meta": { "type": "object", "title": "Questionnaire submission policy", "properties": { "allows_anonymous": { "type": "boolean" }, "requires_participant_ip": { "type": "boolean" } }, "required": [ "allows_anonymous", "requires_participant_ip" ], "additionalProperties": false }, "forms_validation_error_item": { "type": "object", "title": "Forms validation error", "properties": { "title": { "type": "string" }, "code": { "type": "string" }, "pointer": { "type": "string", "description": "JSON Pointer into the request body" }, "question_id": { "type": "string", "nullable": true } }, "required": [ "title", "code" ], "additionalProperties": false }, "forms_validation_error_response": { "type": "object", "title": "Forms validation error response", "properties": { "meta": { "$ref": "#/components/schemas/forms_locale_meta" }, "errors": { "type": "array", "items": { "$ref": "#/components/schemas/forms_validation_error_item" } } }, "required": [ "errors" ], "additionalProperties": false }, "questionnaire": { "type": "object", "title": "Questionnaire", "description": "Decidim::Forms::Questionnaire with JSON Schema and JSON Forms UI for answer submission.", "properties": { "id": { "type": "string" }, "type": { "type": "string", "enum": [ "questionnaires" ] }, "attributes": { "type": "object", "properties": { "title": { "type": "string", "nullable": true, "description": "Localized title for the active locale" }, "description": { "type": "string", "nullable": true, "description": "Localized description for the active locale" }, "schema": { "type": "object", "description": "JSON Schema (structural only)" }, "ui": { "type": "object", "description": "JSON Forms UI schema" }, "updated_at": { "type": "string", "format": "date-time", "nullable": true } }, "additionalProperties": true }, "meta": { "type": "object", "properties": { "locale": { "type": "string" }, "requested_locale": { "type": "string" }, "fallback_from": { "type": "string", "nullable": true }, "submission": { "$ref": "#/components/schemas/forms_submission_policy_meta" } }, "additionalProperties": true }, "links": { "type": "object", "properties": { "self": { "$ref": "#/components/schemas/rest_full_hypermedia_link" }, "submit": { "$ref": "#/components/schemas/rest_full_hypermedia_link" }, "submit_sync": { "$ref": "#/components/schemas/rest_full_hypermedia_link" }, "questions": { "$ref": "#/components/schemas/rest_full_hypermedia_link" } }, "additionalProperties": { "$ref": "#/components/schemas/rest_full_hypermedia_link" } } }, "required": [ "id", "type" ] }, "questionnaire_index_response": { "type": "object", "title": "Questionnaire Index Response", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/questionnaire" } } }, "required": [ "data" ] }, "questionnaire_item_response": { "type": "object", "title": "Questionnaire Item Response", "properties": { "data": { "$ref": "#/components/schemas/questionnaire" } }, "required": [ "data" ] }, "questionnaire_response": { "type": "object", "title": "Questionnaire response (submission bundle)", "properties": { "id": { "type": "string" }, "type": { "type": "string", "enum": [ "questionnaire_response" ] }, "attributes": { "type": "object", "properties": { "answers": { "type": "object", "additionalProperties": true, "description": "Map of question_id to answer value" }, "client_ip": { "type": "string", "nullable": true, "description": "Opaque ip_hash digest" } }, "required": [ "answers" ] }, "meta": { "type": "object", "additionalProperties": true }, "links": { "type": "object", "properties": { "self": { "$ref": "#/components/schemas/rest_full_hypermedia_link" } }, "additionalProperties": { "$ref": "#/components/schemas/rest_full_hypermedia_link" } }, "relationships": { "type": "object", "properties": { "questionnaire": { "title": "Questionnaire", "type": "object", "properties": { "data": { "type": "object", "title": "Questionnaire Data", "properties": { "id": { "type": "string", "description": "Resource Id" }, "type": { "type": "string", "enum": [ "questionnaires" ] } }, "required": [ "id", "type" ] } }, "required": [ "data" ] } } } }, "required": [ "id", "type", "attributes" ] }, "questionnaire_response_index_response": { "type": "object", "title": "Questionnaire Response Index Response", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/questionnaire_response" } } }, "required": [ "data" ] }, "questionnaire_response_item_response": { "type": "object", "title": "Questionnaire Response Item Response", "properties": { "data": { "$ref": "#/components/schemas/questionnaire_response" } }, "required": [ "data" ] }, "submission_request": { "type": "object", "title": "Submission request (async answer submit)", "properties": { "id": { "type": "string", "format": "uuid" }, "type": { "type": "string", "enum": [ "submission_request" ] }, "attributes": { "type": "object", "properties": { "status": { "type": "string", "enum": [ "pending", "processing", "completed", "failed" ] } }, "required": [ "status" ] }, "meta": { "type": "object", "properties": { "status": { "type": "string" } } }, "links": { "type": "object", "properties": { "self": { "$ref": "#/components/schemas/rest_full_hypermedia_link" }, "result": { "$ref": "#/components/schemas/rest_full_hypermedia_link" } } } }, "required": [ "id", "type", "attributes", "links" ] }, "submission_request_index_response": { "type": "object", "title": "Submission Request Index Response", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/submission_request" } } }, "required": [ "data" ] }, "submission_request_item_response": { "type": "object", "title": "Submission Request Item Response", "properties": { "data": { "$ref": "#/components/schemas/submission_request" } }, "required": [ "data" ] }, "submission_request_accepted_response": { "type": "object", "title": "Submission request accepted (202)", "properties": { "data": { "$ref": "#/components/schemas/submission_request" } }, "required": [ "data" ] }, "question": { "type": "object", "title": "Question", "description": "Authoring row for a single Decidim::Forms::Question (admin CRUD).", "properties": { "id": { "type": "string" }, "type": { "type": "string", "enum": [ "questions" ] }, "attributes": { "type": "object", "properties": { "position": { "type": "integer" }, "mandatory": { "type": "boolean" }, "question_type": { "type": "string" }, "body": { "type": "object", "additionalProperties": true, "description": "Translated fields (may include machine_translations)" }, "description": { "type": "object", "additionalProperties": true, "nullable": true }, "max_choices": { "type": "integer", "nullable": true }, "max_characters": { "type": "integer", "nullable": true } } }, "relationships": { "type": "object", "properties": { "questionnaire": { "title": "Questionnaire", "type": "object", "properties": { "data": { "type": "object", "title": "Questionnaire Data", "properties": { "id": { "type": "string", "description": "Resource Id" }, "type": { "type": "string", "enum": [ "questionnaires" ] } }, "required": [ "id", "type" ] } }, "required": [ "data" ] } } } }, "required": [ "id", "type" ] }, "question_index_response": { "type": "object", "title": "Question Index Response", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/question" } } }, "required": [ "data" ] }, "question_item_response": { "type": "object", "title": "Question Item Response", "properties": { "data": { "$ref": "#/components/schemas/question" } }, "required": [ "data" ] }, "answer_option": { "type": "object", "title": "Answer option", "description": "Selectable option for single/multiple choice questions.", "properties": { "id": { "type": "string" }, "type": { "type": "string", "enum": [ "answer_options" ] }, "attributes": { "type": "object", "properties": { "body": { "type": "object", "additionalProperties": { "type": "string" } } } }, "relationships": { "type": "object", "properties": { "question": { "title": "Question", "type": "object", "properties": { "data": { "type": "object", "title": "Question Data", "properties": { "id": { "type": "string", "description": "Resource Id" }, "type": { "type": "string", "enum": [ "question" ] } }, "required": [ "id", "type" ] } }, "required": [ "data" ] } } } }, "required": [ "id", "type" ] }, "answer_option_index_response": { "type": "object", "title": "Answer Option Index Response", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/answer_option" } } }, "required": [ "data" ] }, "answer_option_item_response": { "type": "object", "title": "Answer Option Item Response", "properties": { "data": { "$ref": "#/components/schemas/answer_option" } }, "required": [ "data" ] }, "answer": { "type": "object", "title": "Answer row", "description": "Stored Decidim::Forms::Answer (corpus listing, not the submission bundle).", "properties": { "id": { "type": "string" }, "type": { "type": "string", "enum": [ "answers" ] }, "attributes": { "type": "object", "properties": { "body": { "type": "string", "nullable": true }, "question_id": { "type": "string" } } }, "relationships": { "type": "object", "properties": { "questionnaire": { "title": "Questionnaire", "type": "object", "properties": { "data": { "type": "object", "title": "Questionnaire Data", "properties": { "id": { "type": "string", "description": "Resource Id" }, "type": { "type": "string", "enum": [ "questionnaires" ] } }, "required": [ "id", "type" ] } }, "required": [ "data" ] } } } }, "required": [ "id", "type" ] }, "answer_index_response": { "type": "object", "title": "Answer Index Response", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/answer" } } }, "required": [ "data" ] }, "answer_item_response": { "type": "object", "title": "Answer Item Response", "properties": { "data": { "$ref": "#/components/schemas/answer" } }, "required": [ "data" ] }, "question_create_body": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "required": [ "type", "attributes", "relationships" ], "properties": { "type": { "type": "string", "enum": [ "questions" ] }, "attributes": { "oneOf": [ { "type": "object", "required": [ "position", "mandatory", "question_type", "body" ], "properties": { "position": { "type": "integer", "description": "Order within the questionnaire" }, "mandatory": { "type": "boolean" }, "body": { "type": "object", "additionalProperties": { "type": "string" }, "description": "Translated question label" }, "description": { "type": "object", "additionalProperties": { "type": "string" }, "nullable": true }, "question_type": { "type": "string", "enum": [ "single_option", "multiple_option", "sorting", "matrix_single", "matrix_multiple" ] }, "max_choices": { "type": "integer", "nullable": true } }, "additionalProperties": false }, { "type": "object", "required": [ "position", "mandatory", "question_type", "body" ], "properties": { "position": { "type": "integer", "description": "Order within the questionnaire" }, "mandatory": { "type": "boolean" }, "body": { "type": "object", "additionalProperties": { "type": "string" }, "description": "Translated question label" }, "description": { "type": "object", "additionalProperties": { "type": "string" }, "nullable": true }, "question_type": { "type": "string", "enum": [ "long_answer" ] }, "max_characters": { "type": "integer", "nullable": true } }, "additionalProperties": false }, { "type": "object", "required": [ "position", "mandatory", "question_type", "body" ], "properties": { "position": { "type": "integer", "description": "Order within the questionnaire" }, "mandatory": { "type": "boolean" }, "body": { "type": "object", "additionalProperties": { "type": "string" }, "description": "Translated question label" }, "description": { "type": "object", "additionalProperties": { "type": "string" }, "nullable": true }, "question_type": { "type": "string", "enum": [ "short_answer", "files" ] } }, "additionalProperties": false } ] }, "relationships": { "type": "object", "required": [ "questionnaire" ], "properties": { "questionnaire": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "required": [ "type", "id" ], "properties": { "type": { "type": "string", "enum": [ "questionnaires" ] }, "id": { "type": "string" } } } } } } } } } } }, "questionnaire_update_body": { "type": "object", "title": "Questionnaire metadata update payload", "required": [ "data" ], "properties": { "data": { "type": "object", "required": [ "type", "id", "attributes" ], "properties": { "type": { "type": "string", "enum": [ "questionnaires" ] }, "id": { "type": "string" }, "attributes": { "type": "object", "properties": { "title": { "$ref": "#/components/schemas/translated_prop" }, "description": { "$ref": "#/components/schemas/translated_prop" }, "tos": { "$ref": "#/components/schemas/translated_prop" } }, "additionalProperties": false } }, "additionalProperties": false } }, "additionalProperties": false }, "questionnaire_answers_create_body": { "type": "object", "title": "Questionnaire answers submission payload", "properties": { "meta": { "type": "object", "properties": { "locale": { "type": "string" }, "anonymous": { "type": "boolean" }, "client_ip": { "type": "string" } }, "additionalProperties": true }, "data": { "type": "object", "required": [ "type", "attributes", "relationships" ], "properties": { "type": { "type": "string", "enum": [ "questionnaire_response" ] }, "attributes": { "type": "object", "properties": { "answers": { "type": "object", "additionalProperties": true, "description": "Map of question id (string) to answer value" } }, "required": [ "answers" ] }, "relationships": { "type": "object", "properties": { "questionnaire": { "type": "object", "properties": { "data": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "questionnaires" ] }, "id": { "type": "string" } }, "required": [ "type", "id" ] } }, "required": [ "data" ] } }, "required": [ "questionnaire" ] } } } }, "required": [ "data" ], "additionalProperties": false }, "meeting_component": { "type": "object", "title": "Meeting component", "properties": { "id": { "type": "string", "description": "Meeting component Id" }, "type": { "type": "string", "enum": [ "meeting_component" ] }, "attributes": { "title": "Meeting component Attributes", "type": "object", "properties": { "name": { "$ref": "#/components/schemas/translated_prop", "description": "Meeting component name" }, "global_announcement": { "$ref": "#/components/schemas/translated_prop", "description": "Meeting component announcement (intro)" }, "participatory_space_type": { "$ref": "#/components/schemas/space_classes" }, "participatory_space_id": { "type": "string", "description": "Associate space id. Part of the polymorphic association (participatory_space_type,participatory_space_id)" }, "created_at": { "$ref": "#/components/schemas/creation_date" }, "updated_at": { "$ref": "#/components/schemas/edition_date" }, "extended_data": { "type": "object", "additionalProperties": true, "description": "Present when the client has public.component.extended_data.read" }, "manifest_name": { "type": "string", "enum": [ "meetings" ] } }, "required": [ "created_at", "updated_at", "name", "manifest_name", "participatory_space_type", "participatory_space_id" ], "additionalProperties": false }, "meta": { "type": "object", "title": "Meeting component Metadata", "properties": { "published": { "type": "boolean", "description": "Published component?" }, "scopes_enabled": { "type": "boolean", "description": "Meeting component handle scopes?" } }, "additionalProperties": { "oneOf": [ { "type": "boolean" }, { "type": "integer" }, { "type": "string" }, { "$ref": "#/components/schemas/translated_prop" } ] }, "required": [ "published", "scopes_enabled" ] }, "links": { "type": "object", "title": "Meeting component Links", "properties": { "self": { "$ref": "#/components/schemas/resource_link" }, "related": { "$ref": "#/components/schemas/resource_link" } }, "additionalProperties": false, "required": [ "self" ] }, "relationships": { "type": "object", "title": "Meeting component Relationships", "properties": { "resources": { "type": "object", "title": "Meeting component Linked Resources", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/resource_relationship_identifier" }, "title": "Meeting component Linked Resources Data" }, "meta": { "type": "object", "title": "Meeting component Linked Resources Metadata", "properties": { "count": { "type": "integer", "description": "Total count of resources" } }, "required": [ "count" ] } }, "required": [ "data", "meta" ] } } } } }, "meeting_component_index_response": { "type": "object", "title": "Meeting Component Index Response", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/meeting_component" } } }, "required": [ "data" ] }, "meeting_component_item_response": { "type": "object", "title": "Meeting Component Item Response", "properties": { "data": { "$ref": "#/components/schemas/meeting_component" } }, "required": [ "data" ] }, "meeting": { "type": "object", "title": "Meeting", "properties": { "id": { "type": "string", "description": "Meeting Id" }, "type": { "type": "string", "enum": [ "meeting" ] }, "attributes": { "type": "object", "title": "Meeting Attributes", "properties": { "created_at": { "$ref": "#/components/schemas/creation_date" }, "updated_at": { "$ref": "#/components/schemas/edition_date" }, "extended_data": { "type": "object", "additionalProperties": true, "description": "Present when the client has meetings.extended_data.read" } }, "required": [ "created_at", "updated_at" ], "additionalProperties": true }, "links": { "type": "object", "title": "Meeting Links", "properties": { "self": { "$ref": "#/components/schemas/resource_link" }, "collection": { "$ref": "#/components/schemas/resource_link" }, "related": { "$ref": "#/components/schemas/resource_link" } }, "additionalProperties": false, "required": [ "self", "collection", "related" ] }, "relationships": { "type": "object", "title": "Meeting Relationships", "properties": { "space": { "title": "Linked Space", "type": "object", "properties": { "data": { "type": "object", "title": "Linked Space Data", "properties": { "id": { "type": "string", "description": "Resource Id" }, "type": { "$ref": "#/components/schemas/space_type" } }, "required": [ "id", "type" ] } }, "required": [ "data" ] }, "component": { "title": "Linked Meeting Component", "type": "object", "properties": { "data": { "type": "object", "title": "Linked Meeting Component Data", "properties": { "id": { "type": "string", "description": "Resource Id" }, "type": { "type": "string", "enum": [ "meeting_component" ] } }, "required": [ "id", "type" ] } }, "required": [ "data" ] } }, "additionalProperties": false } }, "required": [ "id", "type", "attributes", "links" ] }, "meeting_index_response": { "type": "object", "title": "Meeting Index Response", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/meeting" } } }, "required": [ "data" ] }, "meeting_item_response": { "type": "object", "title": "Meeting Item Response", "properties": { "data": { "$ref": "#/components/schemas/meeting" } }, "required": [ "data" ] }, "proposal_component": { "type": "object", "title": "Proposal Component", "properties": { "id": { "type": "string", "description": "Proposal Component Id" }, "type": { "type": "string", "enum": [ "proposal_component" ] }, "attributes": { "title": "Proposal Component Attributes", "type": "object", "properties": { "name": { "$ref": "#/components/schemas/translated_prop", "description": "Proposal Component name" }, "global_announcement": { "$ref": "#/components/schemas/translated_prop", "description": "Proposal Component announcement (intro)" }, "participatory_space_type": { "$ref": "#/components/schemas/space_classes" }, "participatory_space_id": { "type": "string", "description": "Associate space id. Part of the polymorphic association (participatory_space_type,participatory_space_id)" }, "created_at": { "$ref": "#/components/schemas/creation_date" }, "updated_at": { "$ref": "#/components/schemas/edition_date" }, "extended_data": { "type": "object", "additionalProperties": true, "description": "Present when the client has public.component.extended_data.read" }, "manifest_name": { "type": "string", "enum": [ "proposals" ] } }, "required": [ "created_at", "updated_at", "name", "manifest_name", "participatory_space_type", "participatory_space_id" ], "additionalProperties": false }, "meta": { "type": "object", "title": "Proposal Component Metadata", "properties": { "published": { "type": "boolean", "description": "Published component?" }, "scopes_enabled": { "type": "boolean", "description": "Proposal Component handle scopes?" }, "can_create_proposals": { "type": "boolean", "description": "If the current user can create proposal (component allows, and user did not reach publication limit)" }, "can_vote": { "type": "boolean", "description": "If the current user can vote on the component" }, "can_comment": { "type": "boolean", "description": "If the current user can comment on the component" }, "geocoding_enabled": { "type": "boolean", "description": "If the component needs a map to display its resources" }, "attachments_allowed": { "type": "boolean", "description": "If the component allows to attach files to resources" }, "collaborative_drafts_enabled": { "type": "boolean", "description": "If you can create collaborative draft for the proposal" }, "comments_enabled": { "type": "boolean", "description": "If you can comment on proposals" }, "comments_max_length": { "type": "integer", "description": "Characters limit for comment" }, "default_sort_order": { "type": "string", "enum": [ "random", "recent", "most_voted", "most_endorsed", "most_commented", "most_followed", "with_more_authors", "automatic", "default" ], "description": "Default order of proposals" }, "official_proposals_enabled": { "type": "boolean", "description": "If proposals can be official" }, "participatory_texts_enabled": { "type": "boolean", "description": "If proposals are based on a text modification" }, "proposal_edit_before_minutes": { "type": "integer", "description": "Time in minute participant can edit the proposal" }, "proposal_edit_time": { "type": "string", "enum": [ "infinite", "limited" ], "description": "Type of restriction for proposal edition" }, "proposal_limit": { "type": "integer", "description": "Max proposal per participant. No maximum if value is 0" }, "resources_permissions_enabled": { "type": "boolean", "description": "If authorizations can be defined per proposal" }, "threshold_per_proposal": { "type": "integer", "description": "Threshold to compare similar proposals" }, "vote_limit": { "type": "integer", "description": "Max Number of vote per participant. 0 if no limit" }, "endorsements_enabled": { "type": "boolean", "description": "If endorsements are enabled" }, "votes_enabled": { "type": "boolean", "description": "If votes on proposal are enabled" }, "creation_enabled": { "type": "boolean", "description": "If participant can create proposal are enabled" }, "proposal_answering_enabled": { "type": "boolean", "description": "If officials can answer proposals" }, "amendment_creation_enabled": { "type": "boolean", "description": "If participant can propose an amendment to a proposal" }, "amendment_reaction_enabled": { "type": "boolean", "description": "If participant can react to an amendment of a proposal" }, "amendment_promotion_enabled": { "type": "boolean", "description": "If participant choose an amendment to replace their initial proposal" }, "votes": { "title": "Proposal Vote Weights Options", "description": "Vote weight, if can_vote is true.", "type": "array", "items": { "type": "object", "title": "Proposal Vote Weight", "properties": { "label": { "$ref": "#/components/schemas/translated_prop", "description": "Label to voting button" }, "weight": { "type": "integer", "description": "Value to add to the vote. 0 for abstention" } }, "required": [ "label", "weight" ] } } }, "additionalProperties": { "oneOf": [ { "type": "boolean" }, { "type": "integer" }, { "type": "string" }, { "$ref": "#/components/schemas/translated_prop" } ] }, "required": [ "published", "scopes_enabled", "can_create_proposals", "can_vote", "can_comment", "geocoding_enabled", "attachments_allowed", "vote_limit" ] }, "links": { "type": "object", "title": "Proposal Component Links", "properties": { "self": { "$ref": "#/components/schemas/resource_link" }, "related": { "$ref": "#/components/schemas/resource_link" }, "draft": { "$ref": "#/components/schemas/resource_link" } }, "additionalProperties": false, "required": [ "self" ] }, "relationships": { "type": "object", "title": "Proposal Component Relationships", "properties": { "resources": { "type": "object", "title": "Proposal Component Linked Resources", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/resource_relationship_identifier" }, "title": "Proposal Component Linked Resources Data" }, "meta": { "type": "object", "title": "Proposal Component Linked Resources Metadata", "properties": { "count": { "type": "integer", "description": "Total count of resources" } }, "required": [ "count" ] } }, "required": [ "data", "meta" ] } } } }, "description": "A proposal component can host proposals from participants, and official proposals (proposals from the organization).\nThis component have many metadatas that explain what are the restrictions regarding proposing, voting, commenting, amending or endorsing. \n\nFeatures toggles: \n- `can_create_proposals`: If participants can create proposals\n- `can_vote`: If participants can vote\n- `can_comment`: If participants can comments\n- .... and some more\n\n\n" }, "proposal_component_index_response": { "type": "object", "title": "Proposal Component Index Response", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/proposal_component" } } }, "required": [ "data" ] }, "proposal_component_item_response": { "type": "object", "title": "Proposal Component Item Response", "properties": { "data": { "$ref": "#/components/schemas/proposal_component" } }, "required": [ "data" ] }, "proposal": { "type": "object", "title": "Proposal", "properties": { "id": { "type": "string", "description": "Proposal Id" }, "type": { "type": "string", "enum": [ "proposal" ] }, "attributes": { "type": "object", "title": "Proposal Attributes", "properties": { "title": { "$ref": "#/components/schemas/translated_prop", "description": "Proposal title" }, "body": { "$ref": "#/components/schemas/translated_prop", "description": "Proposal content" }, "created_at": { "$ref": "#/components/schemas/creation_date" }, "updated_at": { "$ref": "#/components/schemas/edition_date" }, "extended_data": { "type": "object", "additionalProperties": true, "description": "Present when the client has proposals.extended_data.read" } }, "required": [ "created_at", "updated_at", "title", "body" ], "additionalProperties": false }, "meta": { "type": "object", "title": "Proposal Metadata", "properties": { "published": { "type": "boolean", "description": "Whether the proposal is published" }, "scope": { "type": "integer", "description": "Scope Id" }, "voted": { "type": "object", "title": "Current User Proposal Vote Metadata", "properties": { "weight": { "type": "integer", "description": "Vote weight" } }, "required": [ "weight" ], "additionalProperties": false, "nullable": true } }, "additionalProperties": { "oneOf": [ { "type": "boolean" }, { "type": "integer" }, { "type": "string" }, { "$ref": "#/components/schemas/translated_prop" } ] }, "required": [ "published" ] }, "links": { "type": "object", "title": "Proposal Links", "properties": { "self": { "$ref": "#/components/schemas/resource_link" }, "collection": { "$ref": "#/components/schemas/resource_link" }, "related": { "$ref": "#/components/schemas/resource_link" }, "prev": { "$ref": "#/components/schemas/resource_link" }, "next": { "$ref": "#/components/schemas/resource_link" } }, "additionalProperties": false, "required": [ "self", "collection", "related" ] }, "relationships": { "type": "object", "title": "Proposal Relationships", "properties": { "state": { "title": "Proposal State Relationship", "type": "object", "properties": { "data": { "type": "object", "title": "Proposal State Relationship Data", "properties": { "id": { "type": "string", "description": "Resource Id" }, "type": { "type": "string", "enum": [ "proposal_state" ] } }, "required": [ "id", "type" ] }, "meta": { "type": "object", "title": "Proposal State Relationship Metadata", "properties": { "token": { "type": "string", "description": "Proposal State token" } }, "required": [ "token" ] } }, "required": [ "data", "meta" ] }, "space": { "title": "Linked Space", "type": "object", "properties": { "data": { "type": "object", "title": "Linked Space Data", "properties": { "id": { "type": "string", "description": "Resource Id" }, "type": { "$ref": "#/components/schemas/space_type" } }, "required": [ "id", "type" ] } }, "required": [ "data" ] }, "component": { "title": "Linked Proposal Component", "type": "object", "properties": { "data": { "type": "object", "title": "Linked Proposal Component Data", "properties": { "id": { "type": "string", "description": "Resource Id" }, "type": { "type": "string", "enum": [ "proposal_component" ] } }, "required": [ "id", "type" ] } }, "required": [ "data" ] }, "author": { "title": "Proposal's Author", "type": "object", "properties": { "data": { "type": "object", "title": "Proposal's Author Data", "properties": { "id": { "type": "string", "description": "Resource Id" }, "type": { "type": "string", "enum": [ "user", "user_group" ] } }, "required": [ "id", "type" ] } }, "required": [ "data" ] }, "coauthors": { "type": "object", "title": "Proposal's Coauthors", "properties": { "data": { "type": "array", "items": { "type": "object", "title": "Has Many Relation Item", "properties": { "id": { "type": "string", "description": "Resource Id" }, "type": { "type": "string", "enum": [ "user", "user_group" ] } }, "required": [ "id", "type" ] }, "title": "Proposal's Coauthors Data" } }, "required": [ "data" ] } }, "required": [ "component", "space" ], "additionalProperties": false } }, "required": [ "id", "type", "attributes", "meta", "links" ] }, "proposal_index_response": { "type": "object", "title": "Proposal Index Response", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/proposal" } } }, "required": [ "data" ] }, "proposal_item_response": { "type": "object", "title": "Proposal Item Response", "properties": { "data": { "$ref": "#/components/schemas/proposal" } }, "required": [ "data" ] }, "draft_proposal": { "type": "object", "title": "Draft Proposal", "properties": { "id": { "type": "string", "description": "Draft Proposal Id" }, "type": { "type": "string", "enum": [ "draft_proposal" ] }, "attributes": { "title": "Draft Proposal Attributes", "type": "object", "properties": { "title": { "$ref": "#/components/schemas/translated_prop", "description": "Draft Proposal title" }, "body": { "$ref": "#/components/schemas/translated_prop", "description": "Draft Proposal content" }, "errors": { "type": "object", "title": "Draft Proposal Validation Errors", "properties": { "title": { "type": "array", "items": { "type": "string" } }, "body": { "type": "array", "items": { "type": "string" } } }, "required": [ "title", "body" ], "description": "Draft current errors" }, "created_at": { "$ref": "#/components/schemas/creation_date" }, "updated_at": { "$ref": "#/components/schemas/edition_date" } }, "required": [ "created_at", "updated_at", "title", "body" ], "additionalProperties": false }, "meta": { "type": "object", "title": "Draft Proposition Metadata", "properties": { "publishable": { "type": "boolean", "description": "Draft is published as it is now?" }, "client_id": { "type": "string", "description": "Attached client_id" }, "scope": { "type": "integer", "description": "Scope Id" }, "fields": { "type": "array", "description": "Editable field names", "items": { "type": "string" } } }, "additionalProperties": { "oneOf": [ { "type": "boolean" }, { "type": "integer" }, { "type": "string" }, { "$ref": "#/components/schemas/translated_prop" } ] }, "required": [ "publishable", "client_id", "fields" ] }, "links": { "type": "object", "title": "Proposal Links", "properties": { "self": { "$ref": "#/components/schemas/resource_link" }, "collection": { "$ref": "#/components/schemas/resource_link" }, "related": { "$ref": "#/components/schemas/resource_link" } }, "additionalProperties": false, "required": [ "self", "related", "collection" ] }, "relationships": { "type": "object", "title": "Draft Proposal Relationships", "properties": { "space": { "title": "Draft Proposal Related Space", "type": "object", "properties": { "data": { "type": "object", "title": "Draft Proposal Related Space Data", "properties": { "id": { "type": "string", "description": "Resource Id" }, "type": { "$ref": "#/components/schemas/space_type" } }, "required": [ "id", "type" ] } }, "required": [ "data" ] }, "component": { "title": "Draft Proposal Related Component", "type": "object", "properties": { "data": { "type": "object", "title": "Draft Proposal Related Component Data", "properties": { "id": { "type": "string", "description": "Resource Id" }, "type": { "$ref": "#/components/schemas/component_type" } }, "required": [ "id", "type" ] } }, "required": [ "data" ] }, "author": { "title": "Draft Proposal Author", "type": "object", "properties": { "data": { "type": "object", "title": "Draft Proposal Author Data", "properties": { "id": { "type": "string", "description": "Resource Id" }, "type": { "type": "string", "enum": [ "user", "user_group" ] } }, "required": [ "id", "type" ] } }, "required": [ "data" ] }, "coauthors": { "type": "object", "title": "Draft Proposal Coauthors", "properties": { "data": { "type": "array", "items": { "type": "object", "title": "Has Many Relation Item", "properties": { "id": { "type": "string", "description": "Resource Id" }, "type": { "type": "string", "enum": [ "user", "user_group" ] } }, "required": [ "id", "type" ] }, "title": "Draft Proposal Coauthors Data" } }, "required": [ "data" ] } }, "required": [ "component", "space" ], "additionalProperties": false } }, "required": [ "id", "type", "attributes", "meta", "links" ] }, "draft_proposal_index_response": { "type": "object", "title": "Draft Proposal Index Response", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/draft_proposal" } } }, "required": [ "data" ] }, "draft_proposal_item_response": { "type": "object", "title": "Draft Proposal Item Response", "properties": { "data": { "$ref": "#/components/schemas/draft_proposal" } }, "required": [ "data" ] }, "vote_proposal": { "type": "object", "title": "Vote proposal", "description": "A user's vote on a published proposal (Decidim::Proposals::ProposalVote).", "properties": { "id": { "type": "string" }, "type": { "type": "string", "enum": [ "vote_proposals" ] }, "attributes": { "type": "object", "properties": { "weight": { "type": "integer", "description": "Vote weight (0 = abstention when enabled)" }, "created_at": { "$ref": "#/components/schemas/creation_date" }, "updated_at": { "$ref": "#/components/schemas/edition_date" } }, "required": [ "weight", "created_at", "updated_at" ], "additionalProperties": false }, "relationships": { "type": "object", "properties": { "proposal": { "type": "object", "properties": { "data": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "proposals" ] }, "id": { "type": "string" } } } } }, "author": { "type": "object", "properties": { "data": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "users" ] }, "id": { "type": "string" } } } } } } } }, "required": [ "id", "type" ] }, "vote_proposal_index_response": { "type": "object", "title": "Vote Proposal Index Response", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/vote_proposal" } } }, "required": [ "data" ] }, "vote_proposal_item_response": { "type": "object", "title": "Vote Proposal Item Response", "properties": { "data": { "$ref": "#/components/schemas/vote_proposal" } }, "required": [ "data" ] }, "vote_proposal_create_body": { "type": "object", "required": [ "proposal_id", "data" ], "properties": { "proposal_id": { "type": "integer", "description": "Published proposal id" }, "data": { "type": "object", "required": [ "weight" ], "properties": { "weight": { "type": "integer", "description": "Vote weight" } }, "additionalProperties": false } } }, "vote_proposals_index_response": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/vote_proposal" } }, "meta": { "type": "object", "properties": { "page": { "type": "integer" }, "per_page": { "type": "integer" } } } } }, "survey_component": { "type": "object", "title": "Survey component", "properties": { "id": { "type": "string", "description": "Survey component Id" }, "type": { "type": "string", "enum": [ "survey_component" ] }, "attributes": { "title": "Survey component Attributes", "type": "object", "properties": { "name": { "$ref": "#/components/schemas/translated_prop", "description": "Survey component name" }, "global_announcement": { "$ref": "#/components/schemas/translated_prop", "description": "Survey component announcement (intro)" }, "participatory_space_type": { "$ref": "#/components/schemas/space_classes" }, "participatory_space_id": { "type": "string", "description": "Associate space id. Part of the polymorphic association (participatory_space_type,participatory_space_id)" }, "created_at": { "$ref": "#/components/schemas/creation_date" }, "updated_at": { "$ref": "#/components/schemas/edition_date" }, "extended_data": { "type": "object", "additionalProperties": true, "description": "Present when the client has public.component.extended_data.read" }, "manifest_name": { "type": "string", "enum": [ "surveys" ] } }, "required": [ "created_at", "updated_at", "name", "manifest_name", "participatory_space_type", "participatory_space_id" ], "additionalProperties": false }, "meta": { "type": "object", "title": "Survey component Metadata", "properties": { "published": { "type": "boolean", "description": "Published component?" }, "scopes_enabled": { "type": "boolean", "description": "Survey component handle scopes?" } }, "additionalProperties": { "oneOf": [ { "type": "boolean" }, { "type": "integer" }, { "type": "string" }, { "$ref": "#/components/schemas/translated_prop" } ] }, "required": [ "published", "scopes_enabled" ] }, "links": { "type": "object", "title": "Survey component Links", "properties": { "self": { "$ref": "#/components/schemas/resource_link" }, "related": { "$ref": "#/components/schemas/resource_link" } }, "additionalProperties": false, "required": [ "self" ] }, "relationships": { "type": "object", "title": "Survey component Relationships", "properties": { "resources": { "type": "object", "title": "Survey component Linked Resources", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/resource_relationship_identifier" }, "title": "Survey component Linked Resources Data" }, "meta": { "type": "object", "title": "Survey component Linked Resources Metadata", "properties": { "count": { "type": "integer", "description": "Total count of resources" } }, "required": [ "count" ] } }, "required": [ "data", "meta" ] } } } } }, "survey_component_index_response": { "type": "object", "title": "Survey Component Index Response", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/survey_component" } } }, "required": [ "data" ] }, "survey_component_item_response": { "type": "object", "title": "Survey Component Item Response", "properties": { "data": { "$ref": "#/components/schemas/survey_component" } }, "required": [ "data" ] }, "other_component": { "type": "object", "title": "Generic Component", "properties": { "id": { "type": "string", "description": "Generic Component Id" }, "type": { "type": "string", "enum": [ "page_component", "awesome_map_component", "awesome_iframe_component" ] }, "attributes": { "title": "Generic Component Attributes", "type": "object", "properties": { "name": { "$ref": "#/components/schemas/translated_prop", "description": "Generic Component name" }, "global_announcement": { "$ref": "#/components/schemas/translated_prop", "description": "Generic Component announcement (intro)" }, "participatory_space_type": { "$ref": "#/components/schemas/space_classes" }, "participatory_space_id": { "type": "string", "description": "Associate space id. Part of the polymorphic association (participatory_space_type,participatory_space_id)" }, "created_at": { "$ref": "#/components/schemas/creation_date" }, "updated_at": { "$ref": "#/components/schemas/edition_date" }, "extended_data": { "type": "object", "additionalProperties": true, "description": "Present when the client has public.component.extended_data.read" }, "manifest_name": { "type": "string", "enum": [ "pages", "awesome_map", "awesome_iframe" ] } }, "required": [ "created_at", "updated_at", "name", "manifest_name", "participatory_space_type", "participatory_space_id" ], "additionalProperties": false }, "meta": { "type": "object", "title": "Generic Component Metadata", "properties": { "published": { "type": "boolean", "description": "Published component?" }, "scopes_enabled": { "type": "boolean", "description": "Generic Component handle scopes?" } }, "additionalProperties": { "oneOf": [ { "type": "boolean" }, { "type": "integer" }, { "type": "string" }, { "$ref": "#/components/schemas/translated_prop" } ] }, "required": [ "published", "scopes_enabled" ] }, "links": { "type": "object", "title": "Generic Component Links", "properties": { "self": { "$ref": "#/components/schemas/resource_link" }, "related": { "$ref": "#/components/schemas/resource_link" } }, "additionalProperties": false, "required": [ "self" ] }, "relationships": { "type": "object", "title": "Generic Component Relationships", "properties": { "resources": { "type": "object", "title": "Generic Component Linked Resources", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/resource_relationship_identifier" }, "title": "Generic Component Linked Resources Data" }, "meta": { "type": "object", "title": "Generic Component Linked Resources Metadata", "properties": { "count": { "type": "integer", "description": "Total count of resources" } }, "required": [ "count" ] } }, "required": [ "data", "meta" ] } } } } }, "component": { "oneOf": [ { "$ref": "#/components/schemas/accountability_component" }, { "$ref": "#/components/schemas/blog_component" }, { "$ref": "#/components/schemas/budget_component" }, { "$ref": "#/components/schemas/debate_component" }, { "$ref": "#/components/schemas/meeting_component" }, { "$ref": "#/components/schemas/proposal_component" }, { "$ref": "#/components/schemas/survey_component" }, { "$ref": "#/components/schemas/other_component" } ] }, "component_index_response": { "type": "object", "title": "Component Index Response", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/component" } } }, "required": [ "data" ] }, "component_item_response": { "type": "object", "title": "Component Item Response", "properties": { "data": { "$ref": "#/components/schemas/component" } }, "required": [ "data" ] }, "wh_draft_proposal_creation": { "title": "Webhook draft_proposal_creation.succeeded", "type": "object", "properties": { "type": { "type": "string", "enum": [ "draft_proposal_creation.succeeded" ] }, "data": { "$ref": "#/components/schemas/draft_proposal" } }, "required": [ "type", "data" ], "additionalProperties": false }, "wh_draft_proposal_update": { "title": "Webhook draft_proposal_update.succeeded", "type": "object", "properties": { "type": { "type": "string", "enum": [ "draft_proposal_update.succeeded" ] }, "data": { "$ref": "#/components/schemas/draft_proposal" } }, "required": [ "type", "data" ], "additionalProperties": false }, "wh_meeting_upcoming": { "title": "Webhook meetings.upcoming_reminder.succeeded", "type": "object", "properties": { "type": { "type": "string", "enum": [ "meetings.upcoming_reminder.succeeded" ] }, "data": { "type": "object", "description": "JSON:API resource for meetings.upcoming_reminder.succeeded" } }, "required": [ "type", "data" ], "additionalProperties": false }, "wh_pp_step": { "title": "Webhook participatory_process.step_activated.succeeded", "type": "object", "properties": { "type": { "type": "string", "enum": [ "participatory_process.step_activated.succeeded" ] }, "data": { "$ref": "#/components/schemas/space" } }, "required": [ "type", "data" ], "additionalProperties": false }, "wh_proposal_creation": { "title": "Webhook proposal_creation.succeeded", "type": "object", "properties": { "type": { "type": "string", "enum": [ "proposal_creation.succeeded" ] }, "data": { "$ref": "#/components/schemas/proposal" } }, "required": [ "type", "data" ], "additionalProperties": false }, "wh_proposal_state_change": { "title": "Webhook proposal_state_change.succeeded", "type": "object", "properties": { "type": { "type": "string", "enum": [ "proposal_state_change.succeeded" ] }, "data": { "$ref": "#/components/schemas/proposal" } }, "required": [ "type", "data" ], "additionalProperties": false }, "wh_proposal_update": { "title": "Webhook proposal_update.succeeded", "type": "object", "properties": { "type": { "type": "string", "enum": [ "proposal_update.succeeded" ] }, "data": { "$ref": "#/components/schemas/proposal" } }, "required": [ "type", "data" ], "additionalProperties": false }, "wh_system_organizations_created": { "title": "Webhook system.organizations.created", "type": "object", "properties": { "type": { "type": "string", "enum": [ "system.organizations.created" ] }, "data": { "$ref": "#/components/schemas/organization" } }, "required": [ "type", "data" ], "additionalProperties": false }, "wh_system_organizations_deleted": { "title": "Webhook system.organizations.deleted", "type": "object", "properties": { "type": { "type": "string", "enum": [ "system.organizations.deleted" ] }, "data": { "$ref": "#/components/schemas/organization" } }, "required": [ "type", "data" ], "additionalProperties": false }, "wh_system_organizations_updated": { "title": "Webhook system.organizations.updated", "type": "object", "properties": { "type": { "type": "string", "enum": [ "system.organizations.updated" ] }, "data": { "$ref": "#/components/schemas/organization" } }, "required": [ "type", "data" ], "additionalProperties": false }, "wh_user_created": { "title": "Webhook user.created", "type": "object", "properties": { "type": { "type": "string", "enum": [ "user.created" ] }, "data": { "$ref": "#/components/schemas/user" } }, "required": [ "type", "data" ], "additionalProperties": false }, "wh_user_updated": { "title": "Webhook user.updated", "type": "object", "properties": { "type": { "type": "string", "enum": [ "user.updated" ] }, "data": { "$ref": "#/components/schemas/user" } }, "required": [ "type", "data" ], "additionalProperties": false }, "webhook_delivery_envelope": { "title": "Webhook delivery envelope", "description": "JSON body POSTed to integrator URLs when a subscribed event fires.", "oneOf": [ { "$ref": "#/components/schemas/wh_draft_proposal_creation" }, { "$ref": "#/components/schemas/wh_draft_proposal_update" }, { "$ref": "#/components/schemas/wh_meeting_upcoming" }, { "$ref": "#/components/schemas/wh_pp_step" }, { "$ref": "#/components/schemas/wh_proposal_creation" }, { "$ref": "#/components/schemas/wh_proposal_state_change" }, { "$ref": "#/components/schemas/wh_proposal_update" }, { "$ref": "#/components/schemas/wh_system_organizations_created" }, { "$ref": "#/components/schemas/wh_system_organizations_deleted" }, { "$ref": "#/components/schemas/wh_system_organizations_updated" }, { "$ref": "#/components/schemas/wh_user_created" }, { "$ref": "#/components/schemas/wh_user_updated" } ], "discriminator": { "propertyName": "type", "mapping": { "draft_proposal_creation.succeeded": "#/components/schemas/wh_draft_proposal_creation", "draft_proposal_update.succeeded": "#/components/schemas/wh_draft_proposal_update", "meetings.upcoming_reminder.succeeded": "#/components/schemas/wh_meeting_upcoming", "participatory_process.step_activated.succeeded": "#/components/schemas/wh_pp_step", "proposal_creation.succeeded": "#/components/schemas/wh_proposal_creation", "proposal_state_change.succeeded": "#/components/schemas/wh_proposal_state_change", "proposal_update.succeeded": "#/components/schemas/wh_proposal_update", "system.organizations.created": "#/components/schemas/wh_system_organizations_created", "system.organizations.deleted": "#/components/schemas/wh_system_organizations_deleted", "system.organizations.updated": "#/components/schemas/wh_system_organizations_updated", "user.created": "#/components/schemas/wh_user_created", "user.updated": "#/components/schemas/wh_user_updated" } } } } }, "paths": { "/webhook_events/{event_type}": { "get": { "summary": "Show webhook event example payload", "tags": [ "Webhooks" ], "operationId": "showWebhookEventExample", "description": "Returns an example delivery envelope for the given event type, built by serializing a real\nresource in the current organization (same serializers used for outbound delivery).\n", "parameters": [ { "name": "event_type", "in": "path", "required": true, "description": "Event key (e.g. proposal_creation.succeeded)", "schema": { "type": "string" } }, { "name": "Authorization", "in": "header", "schema": { "type": "string" }, "required": false, "description": "Bearer access token (see security schemes)" } ], "security": [ { "credentialFlowBearer": [ "webhooks" ] } ], "responses": { "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } }, "200": { "description": "Example payload", "content": { "application/json": { "examples": { "ok": { "value": { "type": "proposal_creation.succeeded", "data": { "id": "4025", "type": "proposal", "attributes": { "created_at": "2026-08-05T07:05:24Z", "updated_at": "2026-08-05T07:05:24Z", "title": {}, "body": {} }, "relationships": { "space": { "data": { "id": "2401", "type": "participatory_processes" } }, "component": { "data": { "id": "7886", "type": "proposal_component" } }, "author": { "data": { "id": "5108", "type": "user" } }, "coauthors": { "data": [ { "id": "5108", "type": "user" } ], "meta": { "count": 1 } } }, "links": { "related": { "href": "https://9.lvh.me/public/components/7886", "title": " Proposals", "rel": "resource", "meta": { "space_id": "2401", "space_manifest": "participatory_processes", "component_id": "7886", "component_manifest": "proposals", "action_method": "GET" } }, "self": { "href": "https://9.lvh.me/api/rest_full/v0.3/proposals/4025", "title": "Proposals Details", "rel": "resource", "meta": { "component_id": "7886", "component_manifest": "proposals", "space_id": "2401", "space_manifest": "participatory_processes", "resource_id": "4025", "action_method": "GET" } }, "collection": { "href": "https://9.lvh.me/api/rest_full/v0.3/proposals", "title": "Proposals List", "rel": "resource", "meta": { "component_id": "7886", "component_manifest": "proposals", "space_id": "2401", "space_manifest": "participatory_processes", "resource_id": "4025", "action_method": "GET" } } }, "meta": { "published": true } } } } }, "schema": { "$ref": "#/components/schemas/webhook_delivery_envelope" } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "examples": { "forbidden_credentialFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } } }, "schema": { "$ref": "#/components/schemas/error_response" } } } }, "404": { "description": "Unknown event", "content": { "application/json": { "examples": { "not_found": { "value": { "error": "404: Resource not found", "error_description": "Resource not found" } } }, "schema": { "$ref": "#/components/schemas/error_response" } } } } } } }, "/components/proposal_components": { "get": { "summary": "Proposal Components", "tags": [ "Components" ], "operationId": "listProposalComponents", "description": "List or search proposal components of the organization", "parameters": [ { "name": "filter[name_not_in][]", "in": "query", "style": "form", "explode": true, "schema": { "type": "array", "items": { "type": "string" }, "title": "name not IN filter", "description": "match none of _name_'s values in array" }, "required": false }, { "name": "filter[name_in][]", "in": "query", "style": "form", "explode": true, "schema": { "type": "array", "items": { "type": "string" }, "title": "name IN filter", "description": "match one of _name_'s values in array" }, "required": false }, { "name": "filter[name_start]", "in": "query", "schema": { "type": "string", "description": "_name_ starts with", "title": "name starts With filter", "example": "some_string" }, "required": false }, { "name": "filter[name_eq]", "in": "query", "schema": { "type": "string", "title": "name equal filter", "description": "_name_ is equal to" }, "required": false }, { "name": "filter[name_not_eq]", "in": "query", "schema": { "type": "string", "title": "name not equal filter", "description": "_name_ is NOT equal to" }, "required": false }, { "name": "filter[name_matches]", "in": "query", "schema": { "type": "string", "title": "name like filter", "description": "matches _name_ with `LIKE`", "example": "%some_string" }, "required": false }, { "name": "filter[name_blank]", "in": "query", "schema": { "type": "boolean", "title": "name blank filter", "description": "_name_ is null or empty" }, "required": false }, { "name": "filter[participatory_space_type_not_in][]", "in": "query", "style": "form", "explode": true, "schema": { "type": "array", "items": { "type": "string", "example": "Decidim::Assembly" }, "title": "participatory_space_type not IN filter", "description": "match none of _participatory_space_type_'s values in array" }, "required": false }, { "name": "filter[participatory_space_type_in][]", "in": "query", "style": "form", "explode": true, "schema": { "type": "array", "items": { "type": "string", "example": "Decidim::Assembly" }, "title": "participatory_space_type IN filter", "description": "match one of _participatory_space_type_'s values in array" }, "required": false }, { "name": "filter[participatory_space_type_start]", "in": "query", "schema": { "type": "string", "description": "_participatory_space_type_ starts with", "title": "participatory_space_type starts With filter", "example": "some_string" }, "required": false }, { "name": "filter[participatory_space_type_eq]", "in": "query", "schema": { "type": "string", "example": "Decidim::Assembly", "title": "participatory_space_type equal filter", "description": "_participatory_space_type_ is equal to" }, "required": false }, { "name": "filter[participatory_space_type_not_eq]", "in": "query", "schema": { "type": "string", "example": "Decidim::Assembly", "title": "participatory_space_type not equal filter", "description": "_participatory_space_type_ is NOT equal to" }, "required": false }, { "name": "filter[participatory_space_type_matches]", "in": "query", "schema": { "type": "string", "title": "participatory_space_type like filter", "description": "matches _participatory_space_type_ with `LIKE`", "example": "%some_string" }, "required": false }, { "name": "filter[participatory_space_type_blank]", "in": "query", "schema": { "type": "boolean", "title": "participatory_space_type blank filter", "description": "_participatory_space_type_ is null or empty" }, "required": false }, { "name": "filter[participatory_space_id_in][]", "in": "query", "style": "form", "explode": true, "schema": { "type": "array", "items": { "type": "string" }, "title": "participatory_space_id IN filter", "description": "match one of _participatory_space_id_'s values in array" }, "required": false }, { "name": "filter[participatory_space_id_eq]", "in": "query", "schema": { "type": "string", "title": "participatory_space_id equal filter", "description": "_participatory_space_id_ is equal to" }, "required": false }, { "name": "filter[participatory_space_id_lt]", "in": "query", "schema": { "type": "string", "title": "participatory_space_id less than filter", "description": "_participatory_space_id_ is less than" }, "required": false }, { "name": "filter[participatory_space_id_gt]", "in": "query", "schema": { "type": "string", "title": "participatory_space_id greater than filter", "description": "_participatory_space_id_ is greater than" }, "required": false }, { "name": "filter[participatory_space_id_present]", "in": "query", "schema": { "type": "boolean", "title": "participatory_space_id present filter", "description": "_participatory_space_id_ is not null and not empty" }, "required": false }, { "name": "filter[participatory_space_id_blank]", "in": "query", "schema": { "type": "boolean", "title": "participatory_space_id blank filter", "description": "_participatory_space_id_ is null or empty" }, "required": false }, { "name": "page", "in": "query", "description": "Page number for pagination", "required": false, "schema": { "type": "integer" } }, { "name": "per_page", "in": "query", "description": "Number of items per page", "required": false, "schema": { "type": "integer" } }, { "name": "locales[]", "in": "query", "style": "form", "explode": true, "schema": { "type": "array", "title": "Available locales", "description": "List of locale codes the organization exposes.", "items": { "$ref": "#/components/schemas/locale" } }, "required": false }, { "name": "Authorization", "in": "header", "schema": { "type": "string" }, "required": false, "description": "Bearer access token (see security schemes)" } ], "security": [ { "credentialFlowBearer": [ "public" ] } ], "responses": { "200": { "description": "List of proposal components", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/proposal_component_index_response" }, "examples": { "paginated": { "value": { "data": [ { "id": "7935", "type": "proposal_component", "attributes": { "manifest_name": "proposals", "participatory_space_type": "Decidim::Assembly", "participatory_space_id": "1920", "name": { "en": " Sit quaerat occaecati. 3165", "fr": " Error ut beatae. 3166" }, "global_announcement": {}, "created_at": "2026-08-05T07:05:44Z", "updated_at": "2026-08-05T07:05:44Z" }, "relationships": { "resources": { "data": [], "meta": { "count": 0 } } }, "links": { "self": { "href": "https://28.lvh.me/components/proposal_components/7935", "title": " Sit quaerat occaecati. 3165", "rel": "resource", "meta": { "space_id": "1920", "space_manifest": "assemblies", "action_method": "GET" } }, "related": { "href": "https://28.lvh.me/spaces/assemblies/1920", "title": " Eos veritatis velit. 3033", "rel": "resource", "meta": { "space_id": "1920", "space_manifest": "assemblies", "action_method": "GET" } } }, "meta": { "published": true, "scopes_enabled": false, "amendments_enabled": false, "attachments_allowed": false, "comments_enabled": true, "comments_max_length": 1000, "default_sort_order": "default", "geocoding_enabled": false, "minimum_votes_per_user": 0, "official_proposals_enabled": true, "participatory_texts_enabled": false, "proposal_edit_time": "limited", "proposal_limit": 0, "resources_permissions_enabled": true, "threshold_per_proposal": 0, "vote_limit": 0, "collaborative_drafts_enabled": false, "proposal_edit_before_minutes": 5, "votes_enabled": false, "creation_enabled": false, "proposal_answering_enabled": true, "amendment_creation_enabled": true, "amendment_reaction_enabled": true, "amendment_promotion_enabled": true, "endorsements_enabled": true, "can_create_proposals": false, "can_vote": false, "can_endorse": true, "can_comment": true } }, { "id": "7936", "type": "proposal_component", "attributes": { "manifest_name": "proposals", "participatory_space_type": "Decidim::Assembly", "participatory_space_id": "1920", "name": { "en": " Et ut earum. 3174", "fr": " Iusto provident et. 3175" }, "global_announcement": {}, "created_at": "2026-08-05T07:05:44Z", "updated_at": "2026-08-05T07:05:44Z" }, "relationships": { "resources": { "data": [], "meta": { "count": 0 } } }, "links": { "self": { "href": "https://28.lvh.me/components/proposal_components/7936", "title": " Et ut earum. 3174", "rel": "resource", "meta": { "space_id": "1920", "space_manifest": "assemblies", "action_method": "GET" } }, "related": { "href": "https://28.lvh.me/spaces/assemblies/1920", "title": " Eos veritatis velit. 3033", "rel": "resource", "meta": { "space_id": "1920", "space_manifest": "assemblies", "action_method": "GET" } } }, "meta": { "published": true, "scopes_enabled": false, "amendments_enabled": false, "attachments_allowed": false, "comments_enabled": true, "comments_max_length": 1000, "default_sort_order": "default", "geocoding_enabled": false, "minimum_votes_per_user": 0, "official_proposals_enabled": true, "participatory_texts_enabled": false, "proposal_edit_time": "limited", "proposal_limit": 0, "resources_permissions_enabled": true, "threshold_per_proposal": 0, "vote_limit": 0, "collaborative_drafts_enabled": false, "proposal_edit_before_minutes": 5, "votes_enabled": false, "creation_enabled": false, "proposal_answering_enabled": true, "amendment_creation_enabled": true, "amendment_reaction_enabled": true, "amendment_promotion_enabled": true, "endorsements_enabled": true, "can_create_proposals": false, "can_vote": false, "can_endorse": true, "can_comment": true } } ] } }, "ok_with_draft": { "value": { "data": [ { "id": "7945", "type": "proposal_component", "attributes": { "manifest_name": "proposals", "participatory_space_type": "Decidim::ParticipatoryProcess", "participatory_space_id": "2423", "name": { "en": " Quasi numquam ut. 3603", "fr": " Deleniti enim consequatur. 3604" }, "global_announcement": {}, "created_at": "2026-08-05T07:05:46Z", "updated_at": "2026-08-05T07:05:46Z" }, "relationships": { "resources": { "data": [ { "id": "4084", "type": "proposal" }, { "id": "4085", "type": "proposal" }, { "id": "4086", "type": "proposal" } ], "meta": { "count": 3 } } }, "links": { "self": { "href": "https://31.lvh.me/components/proposal_components/7945", "title": " Quasi numquam ut. 3603", "rel": "resource", "meta": { "space_id": "2423", "space_manifest": "participatory_processes", "action_method": "GET" } }, "related": { "href": "https://31.lvh.me/spaces/participatory_processes/2423", "title": " Quia nihil facilis. 3567", "rel": "resource", "meta": { "space_id": "2423", "space_manifest": "participatory_processes", "action_method": "GET" } } }, "meta": { "published": true, "scopes_enabled": false, "amendments_enabled": false, "attachments_allowed": false, "comments_enabled": true, "comments_max_length": 1000, "default_sort_order": "default", "geocoding_enabled": false, "minimum_votes_per_user": 0, "official_proposals_enabled": true, "participatory_texts_enabled": false, "proposal_edit_time": "limited", "proposal_limit": 0, "resources_permissions_enabled": true, "threshold_per_proposal": 0, "vote_limit": 0, "collaborative_drafts_enabled": false, "proposal_edit_before_minutes": 5, "votes_enabled": false, "creation_enabled": false, "proposal_answering_enabled": true, "amendment_creation_enabled": true, "amendment_reaction_enabled": true, "amendment_promotion_enabled": true, "endorsements_enabled": true, "can_create_proposals": false, "can_vote": false, "can_endorse": true, "can_comment": true } }, { "id": "7946", "type": "proposal_component", "attributes": { "manifest_name": "proposals", "participatory_space_type": "Decidim::ParticipatoryProcess", "participatory_space_id": "2423", "name": { "en": " Proposals" }, "global_announcement": {}, "created_at": "2026-08-05T07:05:46Z", "updated_at": "2026-08-05T07:05:46Z" }, "relationships": { "resources": { "data": [], "meta": { "count": 0 } } }, "links": { "self": { "href": "https://31.lvh.me/components/proposal_components/7946", "title": " Proposals", "rel": "resource", "meta": { "space_id": "2423", "space_manifest": "participatory_processes", "action_method": "GET" } }, "related": { "href": "https://31.lvh.me/spaces/participatory_processes/2423", "title": " Quia nihil facilis. 3567", "rel": "resource", "meta": { "space_id": "2423", "space_manifest": "participatory_processes", "action_method": "GET" } } }, "meta": { "published": true, "scopes_enabled": false, "amendments_enabled": false, "attachments_allowed": false, "comments_enabled": true, "comments_max_length": 0, "default_sort_order": "default", "geocoding_enabled": false, "minimum_votes_per_user": 0, "official_proposals_enabled": true, "participatory_texts_enabled": false, "proposal_edit_time": "limited", "proposal_limit": 0, "resources_permissions_enabled": true, "threshold_per_proposal": 0, "vote_limit": 0, "collaborative_drafts_enabled": false, "proposal_edit_before_minutes": 5, "votes_enabled": true, "creation_enabled": false, "proposal_answering_enabled": true, "amendment_creation_enabled": true, "amendment_reaction_enabled": true, "amendment_promotion_enabled": true, "endorsements_enabled": true, "can_create_proposals": false, "can_vote": false, "can_endorse": true, "can_comment": true } }, { "id": "7947", "type": "proposal_component", "attributes": { "manifest_name": "proposals", "participatory_space_type": "Decidim::ParticipatoryProcess", "participatory_space_id": "2423", "name": { "en": " Minima ea est. 3654", "fr": " In esse quas. 3655" }, "global_announcement": {}, "created_at": "2026-08-05T07:05:46Z", "updated_at": "2026-08-05T07:05:46Z" }, "relationships": { "resources": { "data": [ { "id": "4087", "type": "proposal" } ], "meta": { "count": 1 } } }, "links": { "self": { "href": "https://31.lvh.me/components/proposal_components/7947", "title": " Minima ea est. 3654", "rel": "resource", "meta": { "space_id": "2423", "space_manifest": "participatory_processes", "action_method": "GET" } }, "related": { "href": "https://31.lvh.me/spaces/participatory_processes/2423", "title": " Quia nihil facilis. 3567", "rel": "resource", "meta": { "space_id": "2423", "space_manifest": "participatory_processes", "action_method": "GET" } }, "draft": { "href": "https://31.lvh.me/api/rest_full/v0.3/draft_proposals/4087", "title": "Draft Details", "rel": "resource", "meta": { "component_id": "7947", "component_manifest": "proposals", "space_id": "2423", "space_manifest": "participatory_processes", "resource_id": "4087", "action_method": "GET" } } }, "meta": { "published": true, "scopes_enabled": false, "amendments_enabled": false, "attachments_allowed": false, "comments_enabled": true, "comments_max_length": 1000, "default_sort_order": "default", "geocoding_enabled": false, "minimum_votes_per_user": 0, "official_proposals_enabled": true, "participatory_texts_enabled": false, "proposal_edit_time": "limited", "proposal_limit": 0, "resources_permissions_enabled": true, "threshold_per_proposal": 0, "vote_limit": 0, "collaborative_drafts_enabled": false, "proposal_edit_before_minutes": 5, "votes_enabled": false, "creation_enabled": false, "proposal_answering_enabled": true, "amendment_creation_enabled": true, "amendment_reaction_enabled": true, "amendment_promotion_enabled": true, "endorsements_enabled": true, "can_create_proposals": false, "can_vote": false, "can_endorse": true, "can_comment": true } } ] } }, "ok": { "value": { "data": [ { "id": "7926", "type": "proposal_component", "attributes": { "manifest_name": "proposals", "participatory_space_type": "Decidim::ParticipatoryProcess", "participatory_space_id": "2418", "name": { "en": " Quas porro suscipit. 2797", "fr": " Eum soluta cumque. 2798" }, "global_announcement": {}, "created_at": "2026-08-05T07:05:41Z", "updated_at": "2026-08-05T07:05:42Z" }, "relationships": { "resources": { "data": [ { "id": "4069", "type": "proposal" }, { "id": "4070", "type": "proposal" }, { "id": "4071", "type": "proposal" } ], "meta": { "count": 3 } } }, "links": { "self": { "href": "https://26.lvh.me/components/proposal_components/7926", "title": " Quas porro suscipit. 2797", "rel": "resource", "meta": { "space_id": "2418", "space_manifest": "participatory_processes", "action_method": "GET" } }, "related": { "href": "https://26.lvh.me/spaces/participatory_processes/2418", "title": " Quo a quae. 2761", "rel": "resource", "meta": { "space_id": "2418", "space_manifest": "participatory_processes", "action_method": "GET" } } }, "meta": { "published": true, "scopes_enabled": false, "amendments_enabled": false, "attachments_allowed": false, "comments_enabled": true, "comments_max_length": 1000, "default_sort_order": "default", "geocoding_enabled": false, "minimum_votes_per_user": 0, "official_proposals_enabled": true, "participatory_texts_enabled": false, "proposal_edit_time": "limited", "proposal_limit": 0, "resources_permissions_enabled": true, "threshold_per_proposal": 0, "vote_limit": 0, "collaborative_drafts_enabled": false, "proposal_edit_before_minutes": 5, "votes_enabled": false, "creation_enabled": false, "proposal_answering_enabled": true, "amendment_creation_enabled": true, "amendment_reaction_enabled": true, "amendment_promotion_enabled": true, "endorsements_enabled": true, "can_create_proposals": false, "can_vote": false, "can_endorse": true, "can_comment": true } }, { "id": "7927", "type": "proposal_component", "attributes": { "manifest_name": "proposals", "participatory_space_type": "Decidim::ParticipatoryProcess", "participatory_space_id": "2418", "name": { "en": " Proposals" }, "global_announcement": {}, "created_at": "2026-08-05T07:05:42Z", "updated_at": "2026-08-05T07:05:42Z" }, "relationships": { "resources": { "data": [], "meta": { "count": 0 } } }, "links": { "self": { "href": "https://26.lvh.me/components/proposal_components/7927", "title": " Proposals", "rel": "resource", "meta": { "space_id": "2418", "space_manifest": "participatory_processes", "action_method": "GET" } }, "related": { "href": "https://26.lvh.me/spaces/participatory_processes/2418", "title": " Quo a quae. 2761", "rel": "resource", "meta": { "space_id": "2418", "space_manifest": "participatory_processes", "action_method": "GET" } } }, "meta": { "published": true, "scopes_enabled": false, "amendments_enabled": false, "attachments_allowed": false, "comments_enabled": true, "comments_max_length": 0, "default_sort_order": "default", "geocoding_enabled": false, "minimum_votes_per_user": 0, "official_proposals_enabled": true, "participatory_texts_enabled": false, "proposal_edit_time": "limited", "proposal_limit": 0, "resources_permissions_enabled": true, "threshold_per_proposal": 0, "vote_limit": 0, "collaborative_drafts_enabled": false, "proposal_edit_before_minutes": 5, "votes_enabled": true, "creation_enabled": false, "proposal_answering_enabled": true, "amendment_creation_enabled": true, "amendment_reaction_enabled": true, "amendment_promotion_enabled": true, "endorsements_enabled": true, "can_create_proposals": false, "can_vote": false, "can_endorse": true, "can_comment": true } } ] } }, "components_in_Process": { "value": { "data": [ { "id": "7924", "type": "proposal_component", "attributes": { "manifest_name": "proposals", "participatory_space_type": "Decidim::ParticipatoryProcess", "participatory_space_id": "2417", "name": { "en": " Officia aut tenetur. 2652", "fr": " Velit sint magnam. 2653" }, "global_announcement": {}, "created_at": "2026-08-05T07:05:41Z", "updated_at": "2026-08-05T07:05:41Z" }, "relationships": { "resources": { "data": [ { "id": "4066", "type": "proposal" }, { "id": "4067", "type": "proposal" }, { "id": "4068", "type": "proposal" } ], "meta": { "count": 3 } } }, "links": { "self": { "href": "https://25.lvh.me/components/proposal_components/7924", "title": " Officia aut tenetur. 2652", "rel": "resource", "meta": { "space_id": "2417", "space_manifest": "participatory_processes", "action_method": "GET" } }, "related": { "href": "https://25.lvh.me/spaces/participatory_processes/2417", "title": " Perferendis reiciendis voluptates. 2616", "rel": "resource", "meta": { "space_id": "2417", "space_manifest": "participatory_processes", "action_method": "GET" } } }, "meta": { "published": true, "scopes_enabled": false, "amendments_enabled": false, "attachments_allowed": false, "comments_enabled": true, "comments_max_length": 1000, "default_sort_order": "default", "geocoding_enabled": false, "minimum_votes_per_user": 0, "official_proposals_enabled": true, "participatory_texts_enabled": false, "proposal_edit_time": "limited", "proposal_limit": 0, "resources_permissions_enabled": true, "threshold_per_proposal": 0, "vote_limit": 0, "collaborative_drafts_enabled": false, "proposal_edit_before_minutes": 5, "votes_enabled": false, "creation_enabled": false, "proposal_answering_enabled": true, "amendment_creation_enabled": true, "amendment_reaction_enabled": true, "amendment_promotion_enabled": true, "endorsements_enabled": true, "can_create_proposals": false, "can_vote": false, "can_endorse": true, "can_comment": true } }, { "id": "7925", "type": "proposal_component", "attributes": { "manifest_name": "proposals", "participatory_space_type": "Decidim::ParticipatoryProcess", "participatory_space_id": "2417", "name": { "en": " Proposals" }, "global_announcement": {}, "created_at": "2026-08-05T07:05:41Z", "updated_at": "2026-08-05T07:05:41Z" }, "relationships": { "resources": { "data": [], "meta": { "count": 0 } } }, "links": { "self": { "href": "https://25.lvh.me/components/proposal_components/7925", "title": " Proposals", "rel": "resource", "meta": { "space_id": "2417", "space_manifest": "participatory_processes", "action_method": "GET" } }, "related": { "href": "https://25.lvh.me/spaces/participatory_processes/2417", "title": " Perferendis reiciendis voluptates. 2616", "rel": "resource", "meta": { "space_id": "2417", "space_manifest": "participatory_processes", "action_method": "GET" } } }, "meta": { "published": true, "scopes_enabled": false, "amendments_enabled": false, "attachments_allowed": false, "comments_enabled": true, "comments_max_length": 0, "default_sort_order": "default", "geocoding_enabled": false, "minimum_votes_per_user": 0, "official_proposals_enabled": true, "participatory_texts_enabled": false, "proposal_edit_time": "limited", "proposal_limit": 0, "resources_permissions_enabled": true, "threshold_per_proposal": 0, "vote_limit": 0, "collaborative_drafts_enabled": false, "proposal_edit_before_minutes": 5, "votes_enabled": true, "creation_enabled": false, "proposal_answering_enabled": true, "amendment_creation_enabled": true, "amendment_reaction_enabled": true, "amendment_promotion_enabled": true, "endorsements_enabled": true, "can_create_proposals": false, "can_vote": false, "can_endorse": true, "can_comment": true } } ] } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "examples": { "forbidden_credentialFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } }, "forbidden_impersonationFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } } }, "schema": { "$ref": "#/components/schemas/error_response" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } } } } }, "/draft_proposals/{id}/publish/sync": { "post": { "summary": "Publish a draft proposal (sync)", "tags": [ "Draft Proposals" ], "security": [ { "resourceOwnerFlowBearer": [ "proposals" ] } ], "operationId": "publishDraftProposal", "description": "Publish a draft proposal inline and return the published proposal resource.\n\nSame validation rules as the async publish endpoint. Requires impersonation (`proposals.draft`).\n", "parameters": [ { "name": "id", "in": "path", "schema": { "type": "integer", "description": "Draft Id" }, "required": true }, { "name": "Authorization", "in": "header", "schema": { "type": "string" }, "required": false, "description": "Bearer access token (see security schemes)" } ], "responses": { "400": { "description": "Bad request", "content": { "application/json": { "examples": { "bad_request": { "value": { "error": "400: Bad request", "error_description": "Body cannot be blank" } } }, "schema": { "$ref": "#/components/schemas/error_response" } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" }, "examples": { "forbidden_impersonationFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } } } } } }, "200": { "description": "Draft Proposal published", "content": { "application/json": { "examples": { "ok": { "value": { "data": { "id": "4100", "type": "proposal", "attributes": { "created_at": "2026-08-05T07:06:04Z", "updated_at": "2026-08-05T07:06:04Z", "title": { "en": " Et et ex. 4359", "fr": " Veritatis et quaerat. 4360" }, "body": { "en": "

Voluptatem id non. 4362

", "fr": "

Aspernatur perspiciatis fugit. 4363

" } }, "relationships": { "space": { "data": { "id": "2430", "type": "participatory_processes" } }, "component": { "data": { "id": "7957", "type": "proposal_component" } }, "author": { "data": { "id": "5195", "type": "user" } }, "coauthors": { "data": [ { "id": "5195", "type": "user" } ], "meta": { "count": 1 } } }, "links": { "related": { "href": "https://38.lvh.me/public/components/7957", "title": " Id neque error. 4350", "rel": "resource", "meta": { "space_id": "2430", "space_manifest": "participatory_processes", "component_id": "7957", "component_manifest": "proposals", "action_method": "GET" } }, "self": { "href": "https://38.lvh.me/api/rest_full/v0.3/proposals/4100", "title": "Proposals Details", "rel": "resource", "meta": { "component_id": "7957", "component_manifest": "proposals", "space_id": "2430", "space_manifest": "participatory_processes", "resource_id": "4100", "action_method": "GET" } }, "collection": { "href": "https://38.lvh.me/api/rest_full/v0.3/proposals", "title": "Proposals List", "rel": "resource", "meta": { "component_id": "7957", "component_manifest": "proposals", "space_id": "2430", "space_manifest": "participatory_processes", "resource_id": "4100", "action_method": "GET" } } }, "meta": { "published": true, "client_id": 1406 } } } } }, "schema": { "$ref": "#/components/schemas/proposal_item_response" } } } }, "404": { "description": "Not Found", "content": { "application/json": { "examples": { "not_found": { "value": { "error": "404: Resource not found", "error_description": "Resource not found" } } }, "schema": { "$ref": "#/components/schemas/error_response" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } } } } }, "/draft_proposals/{id}/publish": { "post": { "summary": "Publish a draft proposal (async)", "tags": [ "Draft Proposals" ], "security": [ { "resourceOwnerFlowBearer": [ "proposals" ] } ], "operationId": "publishDraftProposalAsync", "description": "Enqueue publication of a draft proposal. Poll `GET /jobs/:uuid` for the published proposal payload.\n\nThe draft must be **publishable** (`meta.publishable` on the last update). Requires impersonation (`proposals.draft`).\n\nFor synchronous publication, use `POST /draft_proposals/{id}/publish/sync`.\n", "parameters": [ { "name": "id", "in": "path", "schema": { "type": "integer", "description": "Draft Id" }, "required": true }, { "name": "Authorization", "in": "header", "schema": { "type": "string" }, "required": false, "description": "Bearer access token (see security schemes)" } ], "responses": { "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "examples": { "forbidden_impersonationFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } } }, "schema": { "$ref": "#/components/schemas/error_response" } } } }, "202": { "description": "Job accepted", "content": { "application/json": { "examples": { "accepted": { "value": { "job_id": "ced5fb18-982a-49bc-98e4-a23000faf772", "status": "pending", "data": null, "return_value": null, "poll_url": "https://44.lvh.me/api/rest_full/v0.3/jobs/ced5fb18-982a-49bc-98e4-a23000faf772", "links": { "self": { "href": "https://44.lvh.me/api/rest_full/v0.3/jobs/ced5fb18-982a-49bc-98e4-a23000faf772", "title": "API job status", "rel": "resource", "meta": { "action_method": "GET" } } } } } }, "schema": { "$ref": "#/components/schemas/rest_full_api_job_accepted" } } } } } } }, "/me/magic_links/{magic_token}": { "get": { "summary": "Use a magic link", "tags": [ "Users" ], "operationId": "signInWithMagicLink", "description": "Challenge given token, open a session and redirect. **Browser-only** — not intended for server-side SDK clients; use `generateMagicLink` and send users the URL instead.\n\nMarked for documentation only; TypeScript clients should not call this operation.\n", "parameters": [ { "name": "magic_token", "in": "path", "schema": { "type": "string", "description": "A token received for magic link" }, "required": true }, { "name": "Authorization", "in": "header", "schema": { "type": "string" }, "required": false, "description": "Bearer access token (see security schemes)" } ], "security": [], "responses": { "400": { "description": "Bad Request", "content": { "application/json": { "examples": { "bad_token": { "value": { "error": "400: Bad request", "error_description": "Token not found" } }, "bad_blocked": { "value": { "error": "400: Bad request", "error_description": "User blocked" } }, "bad_token_expired": { "value": { "error": "400: Bad request", "error_description": "Invalid Token" } } }, "schema": { "$ref": "#/components/schemas/error_response" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } }, "302": { "description": "Signed in", "content": { "application/json": { "examples": { "ok": { "value": {} }, "ok_redirect": { "value": {} } } } } } } } }, "/blogs/{id}": { "get": { "summary": "Show post", "tags": [ "Blogs" ], "security": [ { "credentialFlowBearer": [ "blogs" ] } ], "operationId": "getBlogPost", "description": "Get post details (Decidim::Blogs::Post)", "parameters": [ { "name": "locales[]", "in": "query", "style": "form", "explode": true, "schema": { "type": "array", "title": "Available locales", "description": "List of locale codes the organization exposes.", "items": { "$ref": "#/components/schemas/locale" } }, "required": false }, { "name": "space_manifest", "in": "query", "schema": { "type": "string", "enum": [ "participatory_processes", "assemblies", "conferences", "initiatives" ], "description": "Space type" }, "required": false }, { "name": "space_id", "in": "query", "schema": { "type": "integer", "description": "Space Id" }, "required": false }, { "name": "component_id", "in": "query", "schema": { "type": "integer", "description": "Component Id" }, "required": false }, { "name": "order", "in": "query", "schema": { "type": "string" }, "description": "Order by", "required": false }, { "name": "order_direction", "in": "query", "schema": { "type": "string", "enum": [ "asc", "desc" ] }, "description": "Order direction", "required": false }, { "name": "id", "in": "path", "schema": { "type": "integer", "description": "Post id" }, "required": true }, { "name": "Authorization", "in": "header", "schema": { "type": "string" }, "required": false, "description": "Bearer access token (see security schemes)" } ], "responses": { "403": { "description": "Forbidden", "content": { "application/json": { "examples": { "forbidden_impersonationFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } }, "forbidden_credentialFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } } }, "schema": { "$ref": "#/components/schemas/error_response" } } } }, "200": { "description": "Blog Found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/blog_item_response" }, "examples": { "ok_no_more": { "value": { "data": { "id": "445", "type": "blog", "attributes": { "created_at": "2026-08-05T07:26:17Z", "updated_at": "2026-08-05T07:26:17Z", "title": { "en": " Dolorem ad similique. 125359", "fr": " Placeat atque impedit. 125360" }, "body": { "en": "

Consectetur quis et. 125362

", "fr": "

Repellendus ipsum eveniet. 125363

" }, "published_at": "2026-08-05T07:25:17.845Z" }, "relationships": { "space": { "data": { "id": "3092", "type": "participatory_processes" } }, "component": { "data": { "id": "9768", "type": "blog_component" } } }, "links": { "related": { "href": "https://1327.lvh.me/public/components/9768", "title": " Consequuntur officia et. 125342", "rel": "resource", "meta": { "space_id": "3092", "space_manifest": "participatory_processes", "component_id": "9768", "component_manifest": "blogs", "action_method": "GET" } }, "self": { "href": "https://1327.lvh.me/api/rest_full/v0.3/blogs/445", "title": "Blogs Details", "rel": "resource", "meta": { "component_id": "9768", "component_manifest": "blogs", "space_id": "3092", "space_manifest": "participatory_processes", "resource_id": "445", "action_method": "GET" } }, "collection": { "href": "https://1327.lvh.me/api/rest_full/v0.3/blogs", "title": "Blogs List", "rel": "resource", "meta": { "component_id": "9768", "component_manifest": "blogs", "space_id": "3092", "space_manifest": "participatory_processes", "resource_id": "445", "action_method": "GET" } }, "prev": { "href": "https://1327.lvh.me/api/rest_full/v0.3/blogs/446", "title": "Previous post", "rel": "resource", "meta": { "component_id": "9768", "component_manifest": "blogs", "space_id": "3092", "space_manifest": "participatory_processes", "resource_id": "446", "action_method": "GET" } } }, "meta": { "published": true } } } }, "ok_draft": { "value": { "data": { "id": "415", "type": "blog", "attributes": { "created_at": "2026-08-05T07:26:05Z", "updated_at": "2026-08-05T07:26:05Z", "title": { "en": " Qui est molestiae. 124252", "fr": " Aut voluptas error. 124253" }, "body": { "en": "

Ipsum consectetur sit. 124255

", "fr": "

Aut libero adipisci. 124256

" }, "published_at": "2027-08-05T07:26:05.823Z" }, "relationships": { "space": { "data": { "id": "3075", "type": "participatory_processes" } }, "component": { "data": { "id": "9749", "type": "blog_component" } } }, "links": { "related": { "href": "https://1310.lvh.me/public/components/9749", "title": " Voluptatem quo reprehenderit. 124236", "rel": "resource", "meta": { "space_id": "3075", "space_manifest": "participatory_processes", "component_id": "9749", "component_manifest": "blogs", "action_method": "GET" } }, "self": { "href": "https://1310.lvh.me/api/rest_full/v0.3/blogs/415", "title": "Blogs Details", "rel": "resource", "meta": { "component_id": "9749", "component_manifest": "blogs", "space_id": "3075", "space_manifest": "participatory_processes", "resource_id": "415", "action_method": "GET" } }, "collection": { "href": "https://1310.lvh.me/api/rest_full/v0.3/blogs", "title": "Blogs List", "rel": "resource", "meta": { "component_id": "9749", "component_manifest": "blogs", "space_id": "3075", "space_manifest": "participatory_processes", "resource_id": "415", "action_method": "GET" } }, "next": { "href": "https://1310.lvh.me/api/rest_full/v0.3/blogs/414", "title": "Next post", "rel": "resource", "meta": { "component_id": "9749", "component_manifest": "blogs", "space_id": "3075", "space_manifest": "participatory_processes", "resource_id": "414", "action_method": "GET" } } }, "meta": { "published": false } } } }, "ok": { "value": { "data": { "id": "461", "type": "blog", "attributes": { "created_at": "2026-08-05T07:26:23Z", "updated_at": "2026-08-05T07:26:23Z", "title": { "en": " Tempora consequuntur maiores. 125744", "fr": " Error et nulla. 125745" }, "body": { "en": "

Porro labore voluptas. 125747

", "fr": "

Aut assumenda omnis. 125748

" }, "published_at": "2026-08-03T07:26:22.767Z" }, "relationships": { "space": { "data": { "id": "3097", "type": "participatory_processes" } }, "component": { "data": { "id": "9775", "type": "blog_component" } } }, "links": { "related": { "href": "https://1332.lvh.me/public/components/9775", "title": " Eos debitis voluptate. 125734", "rel": "resource", "meta": { "space_id": "3097", "space_manifest": "participatory_processes", "component_id": "9775", "component_manifest": "blogs", "action_method": "GET" } }, "self": { "href": "https://1332.lvh.me/api/rest_full/v0.3/blogs/461", "title": "Blogs Details", "rel": "resource", "meta": { "component_id": "9775", "component_manifest": "blogs", "space_id": "3097", "space_manifest": "participatory_processes", "resource_id": "461", "action_method": "GET" } }, "collection": { "href": "https://1332.lvh.me/api/rest_full/v0.3/blogs", "title": "Blogs List", "rel": "resource", "meta": { "component_id": "9775", "component_manifest": "blogs", "space_id": "3097", "space_manifest": "participatory_processes", "resource_id": "461", "action_method": "GET" } }, "next": { "href": "https://1332.lvh.me/api/rest_full/v0.3/blogs/464", "title": "Next post", "rel": "resource", "meta": { "component_id": "9775", "component_manifest": "blogs", "space_id": "3097", "space_manifest": "participatory_processes", "resource_id": "464", "action_method": "GET" } }, "prev": { "href": "https://1330.lvh.me/api/rest_full/v0.3/blogs/456", "title": "Previous post", "rel": "resource", "meta": { "component_id": "9773", "component_manifest": "blogs", "space_id": "3095", "space_manifest": "participatory_processes", "resource_id": "456", "action_method": "GET" } } }, "meta": { "published": true } } } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } }, "404": { "description": "Blog Not Found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" }, "examples": { "not_found": { "value": { "error": "404: Resource not found", "error_description": "Resource not found" } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } } } }, "delete": { "summary": "Delete blog post (async)", "tags": [ "Blogs" ], "operationId": "deleteBlogPostAsync", "description": "Enqueue deletion of a blog post. Requires `blogs.destroy`.", "parameters": [ { "name": "id", "in": "path", "schema": { "type": "integer" }, "required": true }, { "name": "Authorization", "in": "header", "schema": { "type": "string" }, "required": false, "description": "Bearer access token (see security schemes)" } ], "security": [ { "resourceOwnerFlowBearer": [ "blogs" ] } ], "responses": { "403": { "description": "Forbidden", "content": { "application/json": { "examples": { "forbidden_impersonationFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } } }, "schema": { "$ref": "#/components/schemas/error_response" } } } }, "202": { "description": "Job accepted", "content": { "application/json": { "examples": { "accepted": { "value": { "job_id": "ed08bd27-3124-41c8-8641-0a154d70bbf9", "status": "pending", "data": null, "return_value": null, "poll_url": "https://952.lvh.me/api/rest_full/v0.3/jobs/ed08bd27-3124-41c8-8641-0a154d70bbf9", "links": { "self": { "href": "https://952.lvh.me/api/rest_full/v0.3/jobs/ed08bd27-3124-41c8-8641-0a154d70bbf9", "title": "API job status", "rel": "resource", "meta": { "action_method": "GET" } } } } } }, "schema": { "$ref": "#/components/schemas/rest_full_api_job_accepted" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } } } } }, "/attachments/direct_upload": { "post": { "summary": "Stage file for direct upload", "tags": [ "Attachments" ], "operationId": "attachmentsDirectUpload", "parameters": [ { "name": "filename", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "byte_size", "in": "query", "required": true, "schema": { "type": "integer" } }, { "name": "checksum", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "content_type", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "Authorization", "in": "header", "schema": { "type": "string" }, "required": false, "description": "Bearer access token (see security schemes)" } ], "security": [ { "credentialFlowBearer": [ "attachments" ] } ], "responses": { "201": { "description": "Direct upload prepared", "content": { "application/json": { "examples": { "ok": { "value": { "signed_id": "eyJfcmFpbHMiOnsiZGF0YSI6MTI3MjMsInB1ciI6ImJsb2JfaWQifX0=--103b369431b7490fcdf4cfc19d377b6fb8f877b9", "filename": "hello.pdf", "content_type": "application/pdf", "byte_size": 12345 } } }, "schema": { "$ref": "#/components/schemas/attachment_direct_upload_response" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" }, "examples": { "forbidden_credentialFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } } } } } } } } }, "/webhook_registrations/{id}": { "delete": { "summary": "Delete webhook registration", "tags": [ "Webhooks" ], "operationId": "deleteWebhookRegistration", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "Authorization", "in": "header", "schema": { "type": "string" }, "required": false, "description": "Bearer access token (see security schemes)" } ], "security": [ { "credentialFlowBearer": [ "webhooks" ] } ], "responses": { "403": { "description": "Forbidden", "content": { "application/json": { "examples": { "forbidden_credentialFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } } }, "schema": { "$ref": "#/components/schemas/error_response" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } }, "204": { "description": "Registration deleted", "content": { "application/json": { "examples": { "ok": { "value": {} } } } } } } }, "put": { "summary": "Update webhook registration", "tags": [ "Webhooks" ], "operationId": "updateWebhookRegistration", "description": "Update URL and subscriptions. Does not rotate the signing secret.", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "Authorization", "in": "header", "schema": { "type": "string" }, "required": false, "description": "Bearer access token (see security schemes)" } ], "security": [ { "credentialFlowBearer": [ "webhooks" ] } ], "responses": { "200": { "description": "Registration updated", "content": { "application/json": { "examples": { "ok": { "value": { "data": { "id": "31", "type": "webhook_registration", "attributes": { "url": "https://example.org/hooks/updated", "subscriptions": [ "proposal_creation.succeeded" ], "created_at": "2026-08-05T07:11:26Z", "updated_at": "2026-08-05T07:11:26Z" } } } } }, "schema": { "$ref": "#/components/schemas/webhook_registration_item_response" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "examples": { "forbidden_credentialFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } } }, "schema": { "$ref": "#/components/schemas/error_response" } } } } }, "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/webhook_registration_create_body" } } }, "required": true } }, "get": { "summary": "Show webhook registration", "tags": [ "Webhooks" ], "operationId": "showWebhookRegistration", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "Authorization", "in": "header", "schema": { "type": "string" }, "required": false, "description": "Bearer access token (see security schemes)" } ], "security": [ { "credentialFlowBearer": [ "webhooks" ] } ], "responses": { "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "examples": { "forbidden_credentialFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } } }, "schema": { "$ref": "#/components/schemas/error_response" } } } }, "200": { "description": "Registration found", "content": { "application/json": { "examples": { "ok": { "value": { "data": { "id": "47", "type": "webhook_registration", "attributes": { "url": "https://example.org/hooks/show", "subscriptions": [ "proposal_creation.succeeded" ], "created_at": "2026-08-05T07:28:06Z", "updated_at": "2026-08-05T07:28:06Z" } } } } }, "schema": { "$ref": "#/components/schemas/webhook_registration_item_response" } } } }, "404": { "description": "Not found for another API client", "content": { "application/json": { "examples": { "not_found_other_client": { "value": { "error": "404: Resource not found", "error_description": "Resource not found" } } }, "schema": { "$ref": "#/components/schemas/error_response" } } } } } } }, "/me/extended_data/sync": { "put": { "summary": "Update user extended data", "tags": [ "Users" ], "security": [ { "resourceOwnerFlowBearer": [ "oauth" ] } ], "operationId": "setUserExtendedData", "description": "The extended_data feature allows you to update a hash with recursive merging. Use the body payload with these keys:\n\n1. `data`: The value or hash you want to update.\n2. `object_path`: The dot-style path to the key (e.g., access.this.key).\n\n**Root path**
\nTo update data from root of the hash, use `object_path=\".\"`.\n\nExample:\n```\n body={\"data\": {\"name\": \"Jane\"}, \"object_path\": \"personnal\"}\n```\nThis recursively merges data into the hash without removing existing keys.\n\n**Merge some data**
\nInitial hash:\n```json\n {\n \"personnal\": {\"birthday\": \"1989-05-18\"}\n }\n```\nPatch payload:\n```json\n {\n \"data\": {\n \"name\": \"Jane\"\n },\n \"object_path\": \"personnal\"\n }\n```\nResult:\n```\n {\n \"personnal\": {\"birthday\": \"1989-05-18\", \"name\": \"Jane\"}\n }\n```\n\n**Create new Paths**
\nPaths are created as needed.\nExemple:\n```json\n body = {\"data\": {\"external_user_id\": 12}, \"object_path\": \"data-store.my-app.foo\"}\n```\nResult:\n```json\n {\n \"personnal\": {\"birthday\": \"1989-05-18\"},\n \"data-store\": {\"my-app\": {\"foo\": {\"external_user_id\": 12}}}\n }\n```\nAlternatively:\n```\n body = {\"data\": 12, \"object_path\": \"data-store.my-app.foo.external_user_id\"}\n```\n\n**Remove a key**
\nSet a key to null or an empty value to remove it.\n\nExample: Initial hash:\n```json\n {\n \"personnal\": {\"birthday\": \"1989-05-18\", \"name\": \"Jane\"}\n }\n```\nPatch:\n```json\n body = {\"data\": {\"birthday\": \"\"}, \"object_path\": \"personnal\"}\n```\n\nResult:\n```\n{\n \"personnal\": {\"name\": \"Jane\"}\n}\n```\n\n**Return Value**
\nThe update request returns the updated value at the specified path.\n\n", "parameters": [ { "name": "Authorization", "in": "header", "schema": { "type": "string" }, "required": false, "description": "Bearer access token (see security schemes)" } ], "responses": { "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" }, "examples": { "forbidden_impersonationFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } } } } } }, "200": { "description": "Update extended data value", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/user_extended_data" }, "examples": { "ok": { "value": { "data": { "foo": "bar" } } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } } }, "requestBody": { "content": { "application/json": { "schema": { "type": "object", "title": "User Extended Data Payload", "properties": { "data": { "type": "object", "title": "User Extended Data Data", "description": "New value for the extended data at the given path" }, "object_path": { "type": "string", "description": "object path, in dot style, like foo.bar. use '.' to update the whole user data" } }, "required": [ "data" ] } } }, "required": true } } }, "/attachments/{id}": { "get": { "summary": "Show attachment", "tags": [ "Attachments" ], "operationId": "showAttachment", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "Authorization", "in": "header", "schema": { "type": "string" }, "required": false, "description": "Bearer access token (see security schemes)" } ], "security": [ { "credentialFlowBearer": [ "attachments" ] } ], "responses": { "403": { "description": "Forbidden", "content": { "application/json": { "examples": { "forbidden_credentialFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } } }, "schema": { "$ref": "#/components/schemas/error_response" } } } }, "200": { "description": "Attachment found", "content": { "application/json": { "examples": { "ok": { "value": { "data": { "id": "10", "type": "attachment", "attributes": { "title": { "en": " Placeat qui quo. 6105", "fr": " Incidunt enim nihil. 6106" }, "description": { "en": " Et saepe in. 6108", "fr": " Odio quaerat voluptatem. 6109" }, "weight": 0, "attachment_collection_id": null, "file_type": "document", "content_type": "application/pdf", "url": null, "thumbnail_url": null, "attached_to": { "type": "Decidim::Proposals::Proposal", "id": 4109 }, "created_at": "2026-08-05T07:06:54Z", "updated_at": "2026-08-05T07:06:54Z" } } } } }, "schema": { "$ref": "#/components/schemas/attachment_item_response" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } } } } }, "/me/extended_data": { "get": { "summary": "Get user extended data", "tags": [ "Users" ], "operationId": "getUserExtendedData", "description": "Fetch user extended data", "parameters": [ { "name": "object_path", "in": "query", "required": true, "schema": { "type": "string", "description": "object path, in dot style, like foo.bar" } }, { "name": "Authorization", "in": "header", "schema": { "type": "string" }, "required": false, "description": "Bearer access token (see security schemes)" } ], "security": [ { "resourceOwnerFlowBearer": [ "oauth" ] } ], "responses": { "200": { "description": "Extended Data for a given object_path given", "content": { "application/json": { "examples": { "ok": { "value": { "data": { "personal": { "birthday": "1989-01-28" }, "birthday": "1989-01-28" } } }, "empty": { "value": { "data": {} } } }, "schema": { "$ref": "#/components/schemas/user_extended_data" } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" }, "examples": { "forbidden_impersonationFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } } } } }, "/draft_proposals/{id}": { "get": { "summary": "Display a draft proposal", "tags": [ "Draft Proposals" ], "operationId": "getDraftProposal", "description": "Detail a draft proposal. Raise HTTP 404 error if no draft is created for now.", "parameters": [ { "name": "id", "in": "path", "schema": { "type": "integer", "description": "Draft Id" }, "required": true }, { "name": "Authorization", "in": "header", "schema": { "type": "string" }, "required": false, "description": "Bearer access token (see security schemes)" } ], "security": [ { "resourceOwnerFlowBearer": [ "proposals" ] } ], "responses": { "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" }, "examples": { "forbidden_impersonationFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } } } } } }, "404": { "description": "Not Found", "content": { "application/json": { "examples": { "not_found": { "value": { "error": "404: Record not found", "error_description": "Record not found" } } }, "schema": { "$ref": "#/components/schemas/error_response" } } } }, "200": { "description": "Draft Found", "content": { "application/json": { "examples": { "ok": { "value": { "data": { "id": "4115", "type": "draft_proposal", "attributes": { "created_at": "2026-08-05T07:07:10Z", "updated_at": "2026-08-05T07:07:10Z", "title": { "fr": " Et nulla beatae. 6602" }, "body": {}, "errors": { "title": [], "body": [ "Body cannot be blank" ] } }, "relationships": { "space": { "data": { "id": "2457", "type": "participatory_processes" } }, "component": { "data": { "id": "7984", "type": "proposal_component" } }, "author": { "data": { "id": "5280", "type": "user" } }, "coauthors": { "data": [ { "id": "5280", "type": "user" } ], "meta": { "count": 1 } } }, "links": { "related": { "href": "https://95.lvh.me/public/components/7984", "title": " Consequuntur sit velit. 6592", "rel": "resource", "meta": { "space_id": "2457", "space_manifest": "participatory_processes", "component_id": "7984", "component_manifest": "proposals", "action_method": "GET" } }, "self": { "href": "https://95.lvh.me/api/rest_full/v0.3/proposals/4115", "title": "Proposals Details", "rel": "resource", "meta": { "component_id": "7984", "component_manifest": "proposals", "space_id": "2457", "space_manifest": "participatory_processes", "resource_id": "4115", "action_method": "GET" } }, "collection": { "href": "https://95.lvh.me/api/rest_full/v0.3/proposals", "title": "Proposals List", "rel": "resource", "meta": { "component_id": "7984", "component_manifest": "proposals", "space_id": "2457", "space_manifest": "participatory_processes", "resource_id": "4115", "action_method": "GET" } } }, "meta": { "publishable": false, "client_id": "fG9mPEdoX01KoqT7ctQF6fh6_5xDBoYI8K6Dx68Zd9M", "fields": [ "title", "body" ] } } } } }, "schema": { "$ref": "#/components/schemas/draft_proposal_item_response" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } } } } }, "/roles": { "get": { "summary": "List roles", "tags": [ "Roles" ], "operationId": "listRoles", "description": "List roles scoped to the current organization (from Decidim state: admin users, participatory space roles, assembly members)", "parameters": [ { "name": "page", "in": "query", "description": "Page number for pagination", "required": false, "schema": { "type": "integer" } }, { "name": "per_page", "in": "query", "description": "Number of items per page", "required": false, "schema": { "type": "integer" } }, { "name": "filter[user_id_in][]", "in": "query", "style": "form", "explode": true, "schema": { "type": "array", "items": { "type": "integer" }, "title": "user_id IN filter", "description": "match one of _user_id_'s values in array" }, "required": false }, { "name": "filter[user_id_eq]", "in": "query", "schema": { "type": "integer", "title": "user_id equal filter", "description": "_user_id_ is equal to" }, "required": false }, { "name": "filter[user_id_lt]", "in": "query", "schema": { "type": "integer", "title": "user_id less than filter", "description": "_user_id_ is less than" }, "required": false }, { "name": "filter[user_id_gt]", "in": "query", "schema": { "type": "integer", "title": "user_id greater than filter", "description": "_user_id_ is greater than" }, "required": false }, { "name": "filter[user_id_present]", "in": "query", "schema": { "type": "boolean", "title": "user_id present filter", "description": "_user_id_ is not null and not empty" }, "required": false }, { "name": "filter[user_id_blank]", "in": "query", "schema": { "type": "boolean", "title": "user_id blank filter", "description": "_user_id_ is null or empty" }, "required": false }, { "name": "filter[resource_id_in][]", "in": "query", "style": "form", "explode": true, "schema": { "type": "array", "items": { "type": "integer" }, "title": "resource_id IN filter", "description": "match one of _resource_id_'s values in array" }, "required": false }, { "name": "filter[resource_id_eq]", "in": "query", "schema": { "type": "integer", "title": "resource_id equal filter", "description": "_resource_id_ is equal to" }, "required": false }, { "name": "filter[resource_id_lt]", "in": "query", "schema": { "type": "integer", "title": "resource_id less than filter", "description": "_resource_id_ is less than" }, "required": false }, { "name": "filter[resource_id_gt]", "in": "query", "schema": { "type": "integer", "title": "resource_id greater than filter", "description": "_resource_id_ is greater than" }, "required": false }, { "name": "filter[resource_id_present]", "in": "query", "schema": { "type": "boolean", "title": "resource_id present filter", "description": "_resource_id_ is not null and not empty" }, "required": false }, { "name": "filter[resource_id_blank]", "in": "query", "schema": { "type": "boolean", "title": "resource_id blank filter", "description": "_resource_id_ is null or empty" }, "required": false }, { "name": "filter[resource_type_not_in][]", "in": "query", "style": "form", "explode": true, "schema": { "type": "array", "items": { "type": "string" }, "title": "resource_type not IN filter", "description": "match none of _resource_type_'s values in array" }, "required": false }, { "name": "filter[resource_type_in][]", "in": "query", "style": "form", "explode": true, "schema": { "type": "array", "items": { "type": "string" }, "title": "resource_type IN filter", "description": "match one of _resource_type_'s values in array" }, "required": false }, { "name": "filter[resource_type_start]", "in": "query", "schema": { "type": "string", "description": "_resource_type_ starts with", "title": "resource_type starts With filter", "example": "some_string" }, "required": false }, { "name": "filter[resource_type_eq]", "in": "query", "schema": { "type": "string", "title": "resource_type equal filter", "description": "_resource_type_ is equal to" }, "required": false }, { "name": "filter[resource_type_not_eq]", "in": "query", "schema": { "type": "string", "title": "resource_type not equal filter", "description": "_resource_type_ is NOT equal to" }, "required": false }, { "name": "filter[resource_type_matches]", "in": "query", "schema": { "type": "string", "title": "resource_type like filter", "description": "matches _resource_type_ with `LIKE`", "example": "%some_string" }, "required": false }, { "name": "filter[resource_type_blank]", "in": "query", "schema": { "type": "boolean", "title": "resource_type blank filter", "description": "_resource_type_ is null or empty" }, "required": false }, { "name": "filter[type_not_in][]", "in": "query", "style": "form", "explode": true, "schema": { "type": "array", "items": { "type": "string" }, "title": "type not IN filter", "description": "match none of _type_'s values in array" }, "required": false }, { "name": "filter[type_in][]", "in": "query", "style": "form", "explode": true, "schema": { "type": "array", "items": { "type": "string" }, "title": "type IN filter", "description": "match one of _type_'s values in array" }, "required": false }, { "name": "filter[type_start]", "in": "query", "schema": { "type": "string", "description": "_type_ starts with", "title": "type starts With filter", "example": "some_string" }, "required": false }, { "name": "filter[type_eq]", "in": "query", "schema": { "type": "string", "title": "type equal filter", "description": "_type_ is equal to" }, "required": false }, { "name": "filter[type_not_eq]", "in": "query", "schema": { "type": "string", "title": "type not equal filter", "description": "_type_ is NOT equal to" }, "required": false }, { "name": "filter[type_matches]", "in": "query", "schema": { "type": "string", "title": "type like filter", "description": "matches _type_ with `LIKE`", "example": "%some_string" }, "required": false }, { "name": "filter[type_blank]", "in": "query", "schema": { "type": "boolean", "title": "type blank filter", "description": "_type_ is null or empty" }, "required": false }, { "name": "Authorization", "in": "header", "schema": { "type": "string" }, "required": false, "description": "Bearer access token (see security schemes)" } ], "security": [ { "credentialFlowBearer": [ "roles" ] } ], "responses": { "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" }, "examples": { "forbidden_credentialFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } } } } } }, "401": { "description": "Unauthorized when no Bearer token", "content": { "application/json": { "examples": { "unauthorized": { "value": { "error": "401: Unauthorized access", "error_description": "Unauthorized access" } } }, "schema": { "$ref": "#/components/schemas/error_response" } } } }, "200": { "description": "Roles listed", "content": { "application/json": { "examples": { "ok": { "value": { "data": [ { "id": "eyJyZXNvdXJjZV90eXBlIjoiRGVjaWRpbTo6T3JnYW5pemF0aW9uIiwicmVzb3VyY2VfaWQiOjE1MjUsInVzZXJfaWQiOjUyODMsImludml0ZWRfYXQiOm51bGwsInR5cGUiOiJnZW5lcmFsX2FkbWluIn0", "type": "role", "attributes": { "type": "general_admin", "user_id": 5283, "resource_id": 1525, "resource_type": "Decidim::Organization", "invited_at": null, "accepted_invite": true, "created_at": "2026-08-05T07:07:19Z", "updated_at": "2026-08-05T07:07:19Z" } }, { "id": "eyJyZXNvdXJjZV90eXBlIjoiRGVjaWRpbTo6UGFydGljaXBhdG9yeVByb2Nlc3MiLCJyZXNvdXJjZV9pZCI6MjQ1OSwidXNlcl9pZCI6NTI4MywiaW52aXRlZF9hdCI6bnVsbCwidHlwZSI6InNwYWNlX2FkbWluaXN0cmF0b3IifQ", "type": "role", "attributes": { "type": "space_administrator", "user_id": 5283, "resource_id": 2459, "resource_type": "Decidim::ParticipatoryProcess", "invited_at": null, "accepted_invite": true, "created_at": "2026-08-05T07:07:19Z", "updated_at": "2026-08-05T07:07:19Z" } } ] } }, "filter_by_type": { "value": { "data": [ { "id": "eyJyZXNvdXJjZV90eXBlIjoiRGVjaWRpbTo6UGFydGljaXBhdG9yeVByb2Nlc3MiLCJyZXNvdXJjZV9pZCI6MjQ2MCwidXNlcl9pZCI6NTI4NSwiaW52aXRlZF9hdCI6bnVsbCwidHlwZSI6InNwYWNlX2FkbWluaXN0cmF0b3IifQ", "type": "role", "attributes": { "type": "space_administrator", "user_id": 5285, "resource_id": 2460, "resource_type": "Decidim::ParticipatoryProcess", "invited_at": null, "accepted_invite": true, "created_at": "2026-08-05T07:07:20Z", "updated_at": "2026-08-05T07:07:20Z" } } ] } }, "filter_by_user_id": { "value": { "data": [ { "id": "eyJyZXNvdXJjZV90eXBlIjoiRGVjaWRpbTo6T3JnYW5pemF0aW9uIiwicmVzb3VyY2VfaWQiOjE1MjksInVzZXJfaWQiOjUyODcsImludml0ZWRfYXQiOm51bGwsInR5cGUiOiJnZW5lcmFsX2FkbWluIn0", "type": "role", "attributes": { "type": "general_admin", "user_id": 5287, "resource_id": 1529, "resource_type": "Decidim::Organization", "invited_at": null, "accepted_invite": true, "created_at": "2026-08-05T07:07:21Z", "updated_at": "2026-08-05T07:07:21Z" } }, { "id": "eyJyZXNvdXJjZV90eXBlIjoiRGVjaWRpbTo6UGFydGljaXBhdG9yeVByb2Nlc3MiLCJyZXNvdXJjZV9pZCI6MjQ2MSwidXNlcl9pZCI6NTI4NywiaW52aXRlZF9hdCI6bnVsbCwidHlwZSI6InNwYWNlX2FkbWluaXN0cmF0b3IifQ", "type": "role", "attributes": { "type": "space_administrator", "user_id": 5287, "resource_id": 2461, "resource_type": "Decidim::ParticipatoryProcess", "invited_at": null, "accepted_invite": true, "created_at": "2026-08-05T07:07:21Z", "updated_at": "2026-08-05T07:07:21Z" } } ] } }, "filter_by_participatory_space_and_type": { "value": { "data": [ { "id": "eyJyZXNvdXJjZV90eXBlIjoiRGVjaWRpbTo6UGFydGljaXBhdG9yeVByb2Nlc3MiLCJyZXNvdXJjZV9pZCI6MjQ2MiwidXNlcl9pZCI6NTI4OSwiaW52aXRlZF9hdCI6bnVsbCwidHlwZSI6InNwYWNlX2FkbWluaXN0cmF0b3IifQ", "type": "role", "attributes": { "type": "space_administrator", "user_id": 5289, "resource_id": 2462, "resource_type": "Decidim::ParticipatoryProcess", "invited_at": null, "accepted_invite": true, "created_at": "2026-08-05T07:07:21Z", "updated_at": "2026-08-05T07:07:21Z" } } ] } }, "filter_by_resource_type": { "value": { "data": [ { "id": "eyJyZXNvdXJjZV90eXBlIjoiRGVjaWRpbTo6UGFydGljaXBhdG9yeVByb2Nlc3MiLCJyZXNvdXJjZV9pZCI6MjQ2MywidXNlcl9pZCI6NTI5MSwiaW52aXRlZF9hdCI6bnVsbCwidHlwZSI6InNwYWNlX2FkbWluaXN0cmF0b3IifQ", "type": "role", "attributes": { "type": "space_administrator", "user_id": 5291, "resource_id": 2463, "resource_type": "Decidim::ParticipatoryProcess", "invited_at": null, "accepted_invite": true, "created_at": "2026-08-05T07:07:22Z", "updated_at": "2026-08-05T07:07:22Z" } } ] } } }, "schema": { "$ref": "#/components/schemas/role_index_response" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } } } } }, "/questionnaire_responses/{id}": { "get": { "summary": "Show questionnaire response", "tags": [ "Forms" ], "security": [ { "credentialFlowBearer": [ "surveys" ] } ], "operationId": "getQuestionnaireResponse", "description": "Read a submission bundle (aggregate of Decidim::Forms::Answer rows).", "parameters": [ { "name": "id", "in": "path", "schema": { "type": "integer" }, "required": true }, { "name": "Authorization", "in": "header", "schema": { "type": "string" }, "required": false, "description": "Bearer access token (see security schemes)" } ], "responses": { "403": { "description": "Forbidden", "content": { "application/json": { "examples": { "forbidden_credentialFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } } }, "schema": { "$ref": "#/components/schemas/error_response" } } } }, "200": { "description": "Questionnaire response", "content": { "application/json": { "examples": { "ok": { "value": { "data": { "id": "10", "type": "questionnaire_response", "attributes": { "answers": { "155": "Stored answer" }, "client_ip": null }, "relationships": { "questionnaire": { "data": { "id": "2814", "type": "questionnaires" } } }, "links": { "self": { "href": "https://115.lvh.me/api/questionnaire_responses/10", "rel": "self", "meta": { "action_method": "GET" } } }, "meta": { "locale": "en", "requested_locale": "en", "fallback_from": null, "user": null, "created_at": "2026-08-05T07:07:35Z" } } } } }, "schema": { "$ref": "#/components/schemas/questionnaire_response_item_response" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } } } } }, "/proposals": { "get": { "summary": "Proposals", "tags": [ "Proposals" ], "operationId": "listProposals", "description": "Search proposals", "parameters": [ { "name": "locales[]", "in": "query", "style": "form", "explode": true, "schema": { "type": "array", "title": "Available locales", "description": "List of locale codes the organization exposes.", "items": { "$ref": "#/components/schemas/locale" } }, "required": false }, { "name": "page", "in": "query", "description": "Page number for pagination", "required": false, "schema": { "type": "integer" } }, { "name": "per_page", "in": "query", "description": "Number of items per page", "required": false, "schema": { "type": "integer" } }, { "name": "space_manifest", "in": "query", "schema": { "type": "string", "enum": [ "participatory_processes", "assemblies", "conferences", "initiatives" ], "description": "Space type" }, "required": false }, { "name": "space_id", "in": "query", "schema": { "type": "integer", "description": "Space Id" }, "required": false }, { "name": "component_id", "in": "query", "schema": { "type": "integer", "description": "Component Id" }, "required": false }, { "name": "order", "in": "query", "schema": { "type": "string", "enum": [ "published_at", "rand" ] }, "description": "Order by", "required": false }, { "name": "order_direction", "in": "query", "schema": { "type": "string", "enum": [ "asc", "desc" ] }, "description": "Order direction", "required": false }, { "name": "filter[voted_weight_in][]", "in": "query", "style": "form", "explode": true, "schema": { "type": "array", "items": { "type": "string" }, "title": "voted_weight IN filter", "description": "match one of _voted_weight_'s values in array. Only available with [:impersonationFlow] flow" }, "required": false }, { "name": "filter[voted_weight_eq]", "in": "query", "schema": { "type": "string", "title": "voted_weight equal filter", "description": "_voted_weight_ is equal to. Only available with [:impersonationFlow] flow" }, "required": false }, { "name": "filter[voted_weight_lt]", "in": "query", "schema": { "type": "string", "title": "voted_weight less than filter", "description": "_voted_weight_ is less than. Only available with [:impersonationFlow] flow" }, "required": false }, { "name": "filter[voted_weight_gt]", "in": "query", "schema": { "type": "string", "title": "voted_weight greater than filter", "description": "_voted_weight_ is greater than. Only available with [:impersonationFlow] flow" }, "required": false }, { "name": "filter[voted_weight_present]", "in": "query", "schema": { "type": "boolean", "title": "voted_weight present filter", "description": "_voted_weight_ is not null and not empty. Only available with [:impersonationFlow] flow" }, "required": false }, { "name": "filter[voted_weight_blank]", "in": "query", "schema": { "type": "boolean", "title": "voted_weight blank filter", "description": "_voted_weight_ is null or empty. Only available with [:impersonationFlow] flow" }, "required": false }, { "name": "filter[state_not_in][]", "in": "query", "style": "form", "explode": true, "schema": { "type": "array", "items": { "type": "string" }, "title": "state not IN filter", "description": "match none of _state_'s values in array" }, "required": false }, { "name": "filter[state_in][]", "in": "query", "style": "form", "explode": true, "schema": { "type": "array", "items": { "type": "string" }, "title": "state IN filter", "description": "match one of _state_'s values in array" }, "required": false }, { "name": "filter[state_start]", "in": "query", "schema": { "type": "string", "description": "_state_ starts with", "title": "state starts With filter", "example": "some_string" }, "required": false }, { "name": "filter[state_eq]", "in": "query", "schema": { "type": "string", "title": "state equal filter", "description": "_state_ is equal to" }, "required": false }, { "name": "filter[state_not_eq]", "in": "query", "schema": { "type": "string", "title": "state not equal filter", "description": "_state_ is NOT equal to" }, "required": false }, { "name": "filter[state_matches]", "in": "query", "schema": { "type": "string", "title": "state like filter", "description": "matches _state_ with `LIKE`", "example": "%some_string" }, "required": false }, { "name": "filter[state_blank]", "in": "query", "schema": { "type": "boolean", "title": "state blank filter", "description": "_state_ is null or empty" }, "required": false }, { "name": "filter[extended_data_cont]", "in": "query", "schema": { "type": "string" }, "required": false, "description": "Search on proposal extended_data. Requires `proposals.extended_data.read`. See [Extended data](https://octree-gva.github.io/decidim-rest-full/integrator/extended-data)." }, { "name": "Authorization", "in": "header", "schema": { "type": "string" }, "required": false, "description": "Bearer access token (see security schemes)" } ], "security": [ { "resourceOwnerFlowBearer": [ "proposals" ] } ], "responses": { "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" }, "examples": { "forbidden_impersonationFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } }, "filter_extended_data_forbidden": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } }, "forbidden_credentialFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } }, "200": { "description": "Proposal List", "content": { "application/json": { "examples": { "filter_by_extended_data": { "value": { "data": [ { "id": "4195", "type": "proposal", "attributes": { "created_at": "2026-08-05T07:08:09Z", "updated_at": "2026-08-05T07:08:09Z", "extended_data": { "ext": "1" }, "title": { "en": " Molestiae voluptatem magni. 10273", "fr": " Et quibusdam suscipit. 10274" }, "body": { "en": "

Porro reiciendis consequatur. 10276

", "fr": "

Natus velit consectetur. 10277

" } }, "relationships": { "space": { "data": { "id": "2489", "type": "participatory_processes" } }, "component": { "data": { "id": "8011", "type": "proposal_component" } }, "author": { "data": { "id": "5389", "type": "user" } }, "coauthors": { "data": [ { "id": "5389", "type": "user" } ], "meta": { "count": 1 } } }, "links": { "related": { "href": "https://151.lvh.me/public/components/8011", "title": " Proposals", "rel": "resource", "meta": { "space_id": "2489", "space_manifest": "participatory_processes", "component_id": "8011", "component_manifest": "proposals", "action_method": "GET" } }, "self": { "href": "https://151.lvh.me/api/rest_full/v0.3/proposals/4195", "title": "Proposals Details", "rel": "resource", "meta": { "component_id": "8011", "component_manifest": "proposals", "space_id": "2489", "space_manifest": "participatory_processes", "resource_id": "4195", "action_method": "GET" } }, "collection": { "href": "https://151.lvh.me/api/rest_full/v0.3/proposals", "title": "Proposals List", "rel": "resource", "meta": { "component_id": "8011", "component_manifest": "proposals", "space_id": "2489", "space_manifest": "participatory_processes", "resource_id": "4195", "action_method": "GET" } } }, "meta": { "published": true } } ] } }, "abstentions": { "value": { "data": [ { "id": "4136", "type": "proposal", "attributes": { "created_at": "2026-08-05T07:07:53Z", "updated_at": "2026-08-05T07:07:53Z", "title": { "en": " Dolore id nihil. 8812", "fr": " Debitis ut nisi. 8813" }, "body": { "en": "

Repudiandae earum et. 8815

", "fr": "

Accusamus pariatur ad. 8816

" } }, "relationships": { "space": { "data": { "id": "2476", "type": "participatory_processes" } }, "component": { "data": { "id": "7998", "type": "proposal_component" } }, "author": { "data": { "id": "5320", "type": "user" } }, "coauthors": { "data": [ { "id": "5320", "type": "user" } ], "meta": { "count": 1 } } }, "links": { "related": { "href": "https://138.lvh.me/public/components/7998", "title": " Proposals", "rel": "resource", "meta": { "space_id": "2476", "space_manifest": "participatory_processes", "component_id": "7998", "component_manifest": "proposals", "action_method": "GET" } }, "self": { "href": "https://138.lvh.me/api/rest_full/v0.3/proposals/4136", "title": "Proposals Details", "rel": "resource", "meta": { "component_id": "7998", "component_manifest": "proposals", "space_id": "2476", "space_manifest": "participatory_processes", "resource_id": "4136", "action_method": "GET" } }, "collection": { "href": "https://138.lvh.me/api/rest_full/v0.3/proposals", "title": "Proposals List", "rel": "resource", "meta": { "component_id": "7998", "component_manifest": "proposals", "space_id": "2476", "space_manifest": "participatory_processes", "resource_id": "4136", "action_method": "GET" } } }, "meta": { "published": true, "voted": { "weight": 0 } } } ] } }, "unvoted": { "value": { "data": [ { "id": "4137", "type": "proposal", "attributes": { "created_at": "2026-08-05T07:07:54Z", "updated_at": "2026-08-05T07:07:54Z", "title": { "en": " Accusamus reprehenderit tempora. 8877", "fr": " Saepe dolore pariatur. 8878" }, "body": { "en": "

Aut modi enim. 8880

", "fr": "

Excepturi et commodi. 8881

" } }, "relationships": { "space": { "data": { "id": "2477", "type": "participatory_processes" } }, "component": { "data": { "id": "7999", "type": "proposal_component" } }, "author": { "data": { "id": "5322", "type": "user" } }, "coauthors": { "data": [ { "id": "5322", "type": "user" } ], "meta": { "count": 1 } } }, "links": { "related": { "href": "https://139.lvh.me/public/components/7999", "title": " Proposals", "rel": "resource", "meta": { "space_id": "2477", "space_manifest": "participatory_processes", "component_id": "7999", "component_manifest": "proposals", "action_method": "GET" } }, "self": { "href": "https://139.lvh.me/api/rest_full/v0.3/proposals/4137", "title": "Proposals Details", "rel": "resource", "meta": { "component_id": "7999", "component_manifest": "proposals", "space_id": "2477", "space_manifest": "participatory_processes", "resource_id": "4137", "action_method": "GET" } }, "collection": { "href": "https://139.lvh.me/api/rest_full/v0.3/proposals", "title": "Proposals List", "rel": "resource", "meta": { "component_id": "7999", "component_manifest": "proposals", "space_id": "2477", "space_manifest": "participatory_processes", "resource_id": "4137", "action_method": "GET" } } }, "meta": { "published": true } }, { "id": "4138", "type": "proposal", "attributes": { "created_at": "2026-08-05T07:07:54Z", "updated_at": "2026-08-05T07:07:54Z", "title": { "en": " Quas repudiandae qui. 8890", "fr": " Tenetur dolores qui. 8891" }, "body": { "en": "

Voluptatem rerum distinctio. 8893

", "fr": "

Dignissimos aliquid optio. 8894

" } }, "relationships": { "space": { "data": { "id": "2477", "type": "participatory_processes" } }, "component": { "data": { "id": "7999", "type": "proposal_component" } }, "state": { "data": { "id": "5540", "type": "proposal_state" }, "meta": { "token": "accepted" } }, "author": { "data": { "id": "5323", "type": "user" } }, "coauthors": { "data": [ { "id": "5323", "type": "user" } ], "meta": { "count": 1 } } }, "links": { "related": { "href": "https://139.lvh.me/public/components/7999", "title": " Proposals", "rel": "resource", "meta": { "space_id": "2477", "space_manifest": "participatory_processes", "component_id": "7999", "component_manifest": "proposals", "action_method": "GET" } }, "self": { "href": "https://139.lvh.me/api/rest_full/v0.3/proposals/4138", "title": "Proposals Details", "rel": "resource", "meta": { "component_id": "7999", "component_manifest": "proposals", "space_id": "2477", "space_manifest": "participatory_processes", "resource_id": "4138", "action_method": "GET" } }, "collection": { "href": "https://139.lvh.me/api/rest_full/v0.3/proposals", "title": "Proposals List", "rel": "resource", "meta": { "component_id": "7999", "component_manifest": "proposals", "space_id": "2477", "space_manifest": "participatory_processes", "resource_id": "4138", "action_method": "GET" } } }, "meta": { "published": true } }, { "id": "4139", "type": "proposal", "attributes": { "created_at": "2026-08-05T07:07:55Z", "updated_at": "2026-08-05T07:07:55Z", "title": { "en": " Ipsum nam alias. 8903", "fr": " Maiores animi consequuntur. 8904" }, "body": { "en": "

Repellat iusto quis. 8906

", "fr": "

Deleniti nesciunt aliquid. 8907

" } }, "relationships": { "space": { "data": { "id": "2477", "type": "participatory_processes" } }, "component": { "data": { "id": "7999", "type": "proposal_component" } }, "state": { "data": { "id": "5541", "type": "proposal_state" }, "meta": { "token": "rejected" } }, "author": { "data": { "id": "5324", "type": "user" } }, "coauthors": { "data": [ { "id": "5324", "type": "user" } ], "meta": { "count": 1 } } }, "links": { "related": { "href": "https://139.lvh.me/public/components/7999", "title": " Proposals", "rel": "resource", "meta": { "space_id": "2477", "space_manifest": "participatory_processes", "component_id": "7999", "component_manifest": "proposals", "action_method": "GET" } }, "self": { "href": "https://139.lvh.me/api/rest_full/v0.3/proposals/4139", "title": "Proposals Details", "rel": "resource", "meta": { "component_id": "7999", "component_manifest": "proposals", "space_id": "2477", "space_manifest": "participatory_processes", "resource_id": "4139", "action_method": "GET" } }, "collection": { "href": "https://139.lvh.me/api/rest_full/v0.3/proposals", "title": "Proposals List", "rel": "resource", "meta": { "component_id": "7999", "component_manifest": "proposals", "space_id": "2477", "space_manifest": "participatory_processes", "resource_id": "4139", "action_method": "GET" } } }, "meta": { "published": true } }, { "id": "4140", "type": "proposal", "attributes": { "created_at": "2026-08-05T07:07:55Z", "updated_at": "2026-08-05T07:07:55Z", "title": { "en": " Tempore est itaque. 8916", "fr": " Doloribus cum quaerat. 8917" }, "body": { "en": "

Neque debitis occaecati. 8919

", "fr": "

Ut autem magnam. 8920

" } }, "relationships": { "space": { "data": { "id": "2477", "type": "participatory_processes" } }, "component": { "data": { "id": "7999", "type": "proposal_component" } }, "author": { "data": { "id": "5325", "type": "user" } }, "coauthors": { "data": [ { "id": "5325", "type": "user" } ], "meta": { "count": 1 } } }, "links": { "related": { "href": "https://139.lvh.me/public/components/7999", "title": " Proposals", "rel": "resource", "meta": { "space_id": "2477", "space_manifest": "participatory_processes", "component_id": "7999", "component_manifest": "proposals", "action_method": "GET" } }, "self": { "href": "https://139.lvh.me/api/rest_full/v0.3/proposals/4140", "title": "Proposals Details", "rel": "resource", "meta": { "component_id": "7999", "component_manifest": "proposals", "space_id": "2477", "space_manifest": "participatory_processes", "resource_id": "4140", "action_method": "GET" } }, "collection": { "href": "https://139.lvh.me/api/rest_full/v0.3/proposals", "title": "Proposals List", "rel": "resource", "meta": { "component_id": "7999", "component_manifest": "proposals", "space_id": "2477", "space_manifest": "participatory_processes", "resource_id": "4140", "action_method": "GET" } } }, "meta": { "published": true } }, { "id": "4141", "type": "proposal", "attributes": { "created_at": "2026-08-05T07:07:55Z", "updated_at": "2026-08-05T07:07:55Z", "title": { "en": " Occaecati eligendi delectus. 8929", "fr": " Aspernatur optio et. 8930" }, "body": { "en": "

Omnis molestias qui. 8932

", "fr": "

Sit quos unde. 8933

" } }, "relationships": { "space": { "data": { "id": "2477", "type": "participatory_processes" } }, "component": { "data": { "id": "7999", "type": "proposal_component" } }, "author": { "data": { "id": "5326", "type": "user" } }, "coauthors": { "data": [ { "id": "5326", "type": "user" } ], "meta": { "count": 1 } } }, "links": { "related": { "href": "https://139.lvh.me/public/components/7999", "title": " Proposals", "rel": "resource", "meta": { "space_id": "2477", "space_manifest": "participatory_processes", "component_id": "7999", "component_manifest": "proposals", "action_method": "GET" } }, "self": { "href": "https://139.lvh.me/api/rest_full/v0.3/proposals/4141", "title": "Proposals Details", "rel": "resource", "meta": { "component_id": "7999", "component_manifest": "proposals", "space_id": "2477", "space_manifest": "participatory_processes", "resource_id": "4141", "action_method": "GET" } }, "collection": { "href": "https://139.lvh.me/api/rest_full/v0.3/proposals", "title": "Proposals List", "rel": "resource", "meta": { "component_id": "7999", "component_manifest": "proposals", "space_id": "2477", "space_manifest": "participatory_processes", "resource_id": "4141", "action_method": "GET" } } }, "meta": { "published": true } }, { "id": "4143", "type": "proposal", "attributes": { "created_at": "2026-08-05T07:07:55Z", "updated_at": "2026-08-05T07:07:55Z", "title": { "en": " Et suscipit qui. 8955", "fr": " Officia sed omnis. 8956" }, "body": { "en": "

Laborum repudiandae molestias. 8958

", "fr": "

Sed velit unde. 8959

" } }, "relationships": { "space": { "data": { "id": "2477", "type": "participatory_processes" } }, "component": { "data": { "id": "7999", "type": "proposal_component" } }, "author": { "data": { "id": "5328", "type": "user" } }, "coauthors": { "data": [ { "id": "5328", "type": "user" } ], "meta": { "count": 1 } } }, "links": { "related": { "href": "https://139.lvh.me/public/components/7999", "title": " Proposals", "rel": "resource", "meta": { "space_id": "2477", "space_manifest": "participatory_processes", "component_id": "7999", "component_manifest": "proposals", "action_method": "GET" } }, "self": { "href": "https://139.lvh.me/api/rest_full/v0.3/proposals/4143", "title": "Proposals Details", "rel": "resource", "meta": { "component_id": "7999", "component_manifest": "proposals", "space_id": "2477", "space_manifest": "participatory_processes", "resource_id": "4143", "action_method": "GET" } }, "collection": { "href": "https://139.lvh.me/api/rest_full/v0.3/proposals", "title": "Proposals List", "rel": "resource", "meta": { "component_id": "7999", "component_manifest": "proposals", "space_id": "2477", "space_manifest": "participatory_processes", "resource_id": "4143", "action_method": "GET" } } }, "meta": { "published": true } } ] } }, "unvoted_unordered_list": { "value": { "data": [ { "id": "4147", "type": "proposal", "attributes": { "created_at": "2026-08-05T07:07:57Z", "updated_at": "2026-08-05T07:07:57Z", "title": { "en": " Perferendis iure sint. 9059", "fr": " Veniam deserunt fuga. 9060" }, "body": { "en": "

Qui enim sunt. 9062

", "fr": "

Dicta eaque doloribus. 9063

" } }, "relationships": { "space": { "data": { "id": "2478", "type": "participatory_processes" } }, "component": { "data": { "id": "8000", "type": "proposal_component" } }, "state": { "data": { "id": "5544", "type": "proposal_state" }, "meta": { "token": "rejected" } }, "author": { "data": { "id": "5333", "type": "user" } }, "coauthors": { "data": [ { "id": "5333", "type": "user" } ], "meta": { "count": 1 } } }, "links": { "related": { "href": "https://140.lvh.me/public/components/8000", "title": " Proposals", "rel": "resource", "meta": { "space_id": "2478", "space_manifest": "participatory_processes", "component_id": "8000", "component_manifest": "proposals", "action_method": "GET" } }, "self": { "href": "https://140.lvh.me/api/rest_full/v0.3/proposals/4147", "title": "Proposals Details", "rel": "resource", "meta": { "component_id": "8000", "component_manifest": "proposals", "space_id": "2478", "space_manifest": "participatory_processes", "resource_id": "4147", "action_method": "GET" } }, "collection": { "href": "https://140.lvh.me/api/rest_full/v0.3/proposals", "title": "Proposals List", "rel": "resource", "meta": { "component_id": "8000", "component_manifest": "proposals", "space_id": "2478", "space_manifest": "participatory_processes", "resource_id": "4147", "action_method": "GET" } } }, "meta": { "published": true } } ] } }, "voted": { "value": { "data": [ { "id": "4158", "type": "proposal", "attributes": { "created_at": "2026-08-05T07:07:59Z", "updated_at": "2026-08-05T07:07:59Z", "title": { "en": " Ut sint molestias. 9254", "fr": " Mollitia veniam consequatur. 9255" }, "body": { "en": "

Nemo dignissimos consectetur. 9257

", "fr": "

Repellat labore aperiam. 9258

" } }, "relationships": { "space": { "data": { "id": "2479", "type": "participatory_processes" } }, "component": { "data": { "id": "8001", "type": "proposal_component" } }, "state": { "data": { "id": "5546", "type": "proposal_state" }, "meta": { "token": "accepted" } }, "author": { "data": { "id": "5345", "type": "user" } }, "coauthors": { "data": [ { "id": "5345", "type": "user" } ], "meta": { "count": 1 } } }, "links": { "related": { "href": "https://141.lvh.me/public/components/8001", "title": " Proposals", "rel": "resource", "meta": { "space_id": "2479", "space_manifest": "participatory_processes", "component_id": "8001", "component_manifest": "proposals", "action_method": "GET" } }, "self": { "href": "https://141.lvh.me/api/rest_full/v0.3/proposals/4158", "title": "Proposals Details", "rel": "resource", "meta": { "component_id": "8001", "component_manifest": "proposals", "space_id": "2479", "space_manifest": "participatory_processes", "resource_id": "4158", "action_method": "GET" } }, "collection": { "href": "https://141.lvh.me/api/rest_full/v0.3/proposals", "title": "Proposals List", "rel": "resource", "meta": { "component_id": "8001", "component_manifest": "proposals", "space_id": "2479", "space_manifest": "participatory_processes", "resource_id": "4158", "action_method": "GET" } } }, "meta": { "published": true, "voted": { "weight": 1 } } }, { "id": "4159", "type": "proposal", "attributes": { "created_at": "2026-08-05T07:07:59Z", "updated_at": "2026-08-05T07:07:59Z", "title": { "en": " Tenetur hic sit. 9267", "fr": " Ipsa eius magnam. 9268" }, "body": { "en": "

Et quia sit. 9270

", "fr": "

Officiis molestiae perferendis. 9271

" } }, "relationships": { "space": { "data": { "id": "2479", "type": "participatory_processes" } }, "component": { "data": { "id": "8001", "type": "proposal_component" } }, "author": { "data": { "id": "5346", "type": "user" } }, "coauthors": { "data": [ { "id": "5346", "type": "user" } ], "meta": { "count": 1 } } }, "links": { "related": { "href": "https://141.lvh.me/public/components/8001", "title": " Proposals", "rel": "resource", "meta": { "space_id": "2479", "space_manifest": "participatory_processes", "component_id": "8001", "component_manifest": "proposals", "action_method": "GET" } }, "self": { "href": "https://141.lvh.me/api/rest_full/v0.3/proposals/4159", "title": "Proposals Details", "rel": "resource", "meta": { "component_id": "8001", "component_manifest": "proposals", "space_id": "2479", "space_manifest": "participatory_processes", "resource_id": "4159", "action_method": "GET" } }, "collection": { "href": "https://141.lvh.me/api/rest_full/v0.3/proposals", "title": "Proposals List", "rel": "resource", "meta": { "component_id": "8001", "component_manifest": "proposals", "space_id": "2479", "space_manifest": "participatory_processes", "resource_id": "4159", "action_method": "GET" } } }, "meta": { "published": true, "voted": { "weight": 1 } } } ] } }, "state_accepted": { "value": { "data": [ { "id": "4216", "type": "proposal", "attributes": { "created_at": "2026-08-05T07:08:15Z", "updated_at": "2026-08-05T07:08:15Z", "title": { "en": " Praesentium tenetur quidem. 10864", "fr": " Nostrum soluta quaerat. 10865" }, "body": { "en": "

Rerum eos voluptas. 10867

", "fr": "

Maiores doloribus nam. 10868

" } }, "relationships": { "space": { "data": { "id": "2495", "type": "participatory_processes" } }, "component": { "data": { "id": "8017", "type": "proposal_component" } }, "state": { "data": { "id": "5594", "type": "proposal_state" }, "meta": { "token": "accepted" } }, "author": { "data": { "id": "5410", "type": "user" } }, "coauthors": { "data": [ { "id": "5410", "type": "user" } ], "meta": { "count": 1 } } }, "links": { "related": { "href": "https://157.lvh.me/public/components/8017", "title": " Proposals", "rel": "resource", "meta": { "space_id": "2495", "space_manifest": "participatory_processes", "component_id": "8017", "component_manifest": "proposals", "action_method": "GET" } }, "self": { "href": "https://157.lvh.me/api/rest_full/v0.3/proposals/4216", "title": "Proposals Details", "rel": "resource", "meta": { "component_id": "8017", "component_manifest": "proposals", "space_id": "2495", "space_manifest": "participatory_processes", "resource_id": "4216", "action_method": "GET" } }, "collection": { "href": "https://157.lvh.me/api/rest_full/v0.3/proposals", "title": "Proposals List", "rel": "resource", "meta": { "component_id": "8017", "component_manifest": "proposals", "space_id": "2495", "space_manifest": "participatory_processes", "resource_id": "4216", "action_method": "GET" } } }, "meta": { "published": true } } ] } }, "state_non_rejected": { "value": { "data": [ { "id": "4210", "type": "proposal", "attributes": { "created_at": "2026-08-05T07:08:14Z", "updated_at": "2026-08-05T07:08:14Z", "title": { "en": " Magnam ducimus repudiandae. 10735", "fr": " Aut eum qui. 10736" }, "body": { "en": "

Dolor enim iste. 10738

", "fr": "

Voluptas molestiae iste. 10739

" } }, "relationships": { "space": { "data": { "id": "2494", "type": "participatory_processes" } }, "component": { "data": { "id": "8016", "type": "proposal_component" } }, "author": { "data": { "id": "5404", "type": "user" } }, "coauthors": { "data": [ { "id": "5404", "type": "user" } ], "meta": { "count": 1 } } }, "links": { "related": { "href": "https://156.lvh.me/public/components/8016", "title": " Proposals", "rel": "resource", "meta": { "space_id": "2494", "space_manifest": "participatory_processes", "component_id": "8016", "component_manifest": "proposals", "action_method": "GET" } }, "self": { "href": "https://156.lvh.me/api/rest_full/v0.3/proposals/4210", "title": "Proposals Details", "rel": "resource", "meta": { "component_id": "8016", "component_manifest": "proposals", "space_id": "2494", "space_manifest": "participatory_processes", "resource_id": "4210", "action_method": "GET" } }, "collection": { "href": "https://156.lvh.me/api/rest_full/v0.3/proposals", "title": "Proposals List", "rel": "resource", "meta": { "component_id": "8016", "component_manifest": "proposals", "space_id": "2494", "space_manifest": "participatory_processes", "resource_id": "4210", "action_method": "GET" } } }, "meta": { "published": true } }, { "id": "4211", "type": "proposal", "attributes": { "created_at": "2026-08-05T07:08:14Z", "updated_at": "2026-08-05T07:08:14Z", "title": { "en": " Provident deserunt qui. 10748", "fr": " Est quo temporibus. 10749" }, "body": { "en": "

Ducimus quae corrupti. 10751

", "fr": "

Eaque aut maxime. 10752

" } }, "relationships": { "space": { "data": { "id": "2494", "type": "participatory_processes" } }, "component": { "data": { "id": "8016", "type": "proposal_component" } }, "state": { "data": { "id": "5591", "type": "proposal_state" }, "meta": { "token": "accepted" } }, "author": { "data": { "id": "5405", "type": "user" } }, "coauthors": { "data": [ { "id": "5405", "type": "user" } ], "meta": { "count": 1 } } }, "links": { "related": { "href": "https://156.lvh.me/public/components/8016", "title": " Proposals", "rel": "resource", "meta": { "space_id": "2494", "space_manifest": "participatory_processes", "component_id": "8016", "component_manifest": "proposals", "action_method": "GET" } }, "self": { "href": "https://156.lvh.me/api/rest_full/v0.3/proposals/4211", "title": "Proposals Details", "rel": "resource", "meta": { "component_id": "8016", "component_manifest": "proposals", "space_id": "2494", "space_manifest": "participatory_processes", "resource_id": "4211", "action_method": "GET" } }, "collection": { "href": "https://156.lvh.me/api/rest_full/v0.3/proposals", "title": "Proposals List", "rel": "resource", "meta": { "component_id": "8016", "component_manifest": "proposals", "space_id": "2494", "space_manifest": "participatory_processes", "resource_id": "4211", "action_method": "GET" } } }, "meta": { "published": true } }, { "id": "4213", "type": "proposal", "attributes": { "created_at": "2026-08-05T07:08:14Z", "updated_at": "2026-08-05T07:08:14Z", "title": { "en": " Delectus ipsum rerum. 10774", "fr": " Quia quis eum. 10775" }, "body": { "en": "

Repellendus nulla odio. 10777

", "fr": "

Minima dolores est. 10778

" } }, "relationships": { "space": { "data": { "id": "2494", "type": "participatory_processes" } }, "component": { "data": { "id": "8016", "type": "proposal_component" } }, "author": { "data": { "id": "5407", "type": "user" } }, "coauthors": { "data": [ { "id": "5407", "type": "user" } ], "meta": { "count": 1 } } }, "links": { "related": { "href": "https://156.lvh.me/public/components/8016", "title": " Proposals", "rel": "resource", "meta": { "space_id": "2494", "space_manifest": "participatory_processes", "component_id": "8016", "component_manifest": "proposals", "action_method": "GET" } }, "self": { "href": "https://156.lvh.me/api/rest_full/v0.3/proposals/4213", "title": "Proposals Details", "rel": "resource", "meta": { "component_id": "8016", "component_manifest": "proposals", "space_id": "2494", "space_manifest": "participatory_processes", "resource_id": "4213", "action_method": "GET" } }, "collection": { "href": "https://156.lvh.me/api/rest_full/v0.3/proposals", "title": "Proposals List", "rel": "resource", "meta": { "component_id": "8016", "component_manifest": "proposals", "space_id": "2494", "space_manifest": "participatory_processes", "resource_id": "4213", "action_method": "GET" } } }, "meta": { "published": true } }, { "id": "4214", "type": "proposal", "attributes": { "created_at": "2026-08-05T07:08:14Z", "updated_at": "2026-08-05T07:08:14Z", "title": { "en": " Modi eaque libero. 10787", "fr": " Nobis consequatur rerum. 10788" }, "body": { "en": "

Et amet doloremque. 10790

", "fr": "

Maiores qui sint. 10791

" } }, "relationships": { "space": { "data": { "id": "2494", "type": "participatory_processes" } }, "component": { "data": { "id": "8016", "type": "proposal_component" } }, "author": { "data": { "id": "5408", "type": "user" } }, "coauthors": { "data": [ { "id": "5408", "type": "user" } ], "meta": { "count": 1 } } }, "links": { "related": { "href": "https://156.lvh.me/public/components/8016", "title": " Proposals", "rel": "resource", "meta": { "space_id": "2494", "space_manifest": "participatory_processes", "component_id": "8016", "component_manifest": "proposals", "action_method": "GET" } }, "self": { "href": "https://156.lvh.me/api/rest_full/v0.3/proposals/4214", "title": "Proposals Details", "rel": "resource", "meta": { "component_id": "8016", "component_manifest": "proposals", "space_id": "2494", "space_manifest": "participatory_processes", "resource_id": "4214", "action_method": "GET" } }, "collection": { "href": "https://156.lvh.me/api/rest_full/v0.3/proposals", "title": "Proposals List", "rel": "resource", "meta": { "component_id": "8016", "component_manifest": "proposals", "space_id": "2494", "space_manifest": "participatory_processes", "resource_id": "4214", "action_method": "GET" } } }, "meta": { "published": true } } ] } }, "ok_drafts": { "value": { "data": [ { "id": "4173", "type": "proposal", "attributes": { "created_at": "2026-08-05T07:08:02Z", "updated_at": "2026-08-05T07:08:02Z", "title": { "en": " Quidem harum magni. 9605", "fr": " Quasi sint explicabo. 9606" }, "body": { "en": "

Quisquam ut nisi. 9608

", "fr": "

Est et consequatur. 9609

" } }, "relationships": { "space": { "data": { "id": "2482", "type": "participatory_processes" } }, "component": { "data": { "id": "8004", "type": "proposal_component" } }, "author": { "data": { "id": "5363", "type": "user" } }, "coauthors": { "data": [ { "id": "5363", "type": "user" } ], "meta": { "count": 1 } } }, "links": { "related": { "href": "https://144.lvh.me/public/components/8004", "title": " Proposals", "rel": "resource", "meta": { "space_id": "2482", "space_manifest": "participatory_processes", "component_id": "8004", "component_manifest": "proposals", "action_method": "GET" } }, "self": { "href": "https://144.lvh.me/api/rest_full/v0.3/proposals/4173", "title": "Proposals Details", "rel": "resource", "meta": { "component_id": "8004", "component_manifest": "proposals", "space_id": "2482", "space_manifest": "participatory_processes", "resource_id": "4173", "action_method": "GET" } }, "collection": { "href": "https://144.lvh.me/api/rest_full/v0.3/proposals", "title": "Proposals List", "rel": "resource", "meta": { "component_id": "8004", "component_manifest": "proposals", "space_id": "2482", "space_manifest": "participatory_processes", "resource_id": "4173", "action_method": "GET" } } }, "meta": { "published": true } }, { "id": "4174", "type": "proposal", "attributes": { "created_at": "2026-08-05T07:08:02Z", "updated_at": "2026-08-05T07:08:02Z", "title": { "en": " Non quisquam illum. 9618", "fr": " Voluptatum voluptatem cum. 9619" }, "body": { "en": "

Consequatur praesentium eum. 9621

", "fr": "

Debitis itaque quis. 9622

" } }, "relationships": { "space": { "data": { "id": "2482", "type": "participatory_processes" } }, "component": { "data": { "id": "8004", "type": "proposal_component" } }, "state": { "data": { "id": "5555", "type": "proposal_state" }, "meta": { "token": "accepted" } }, "author": { "data": { "id": "5364", "type": "user" } }, "coauthors": { "data": [ { "id": "5364", "type": "user" } ], "meta": { "count": 1 } } }, "links": { "related": { "href": "https://144.lvh.me/public/components/8004", "title": " Proposals", "rel": "resource", "meta": { "space_id": "2482", "space_manifest": "participatory_processes", "component_id": "8004", "component_manifest": "proposals", "action_method": "GET" } }, "self": { "href": "https://144.lvh.me/api/rest_full/v0.3/proposals/4174", "title": "Proposals Details", "rel": "resource", "meta": { "component_id": "8004", "component_manifest": "proposals", "space_id": "2482", "space_manifest": "participatory_processes", "resource_id": "4174", "action_method": "GET" } }, "collection": { "href": "https://144.lvh.me/api/rest_full/v0.3/proposals", "title": "Proposals List", "rel": "resource", "meta": { "component_id": "8004", "component_manifest": "proposals", "space_id": "2482", "space_manifest": "participatory_processes", "resource_id": "4174", "action_method": "GET" } } }, "meta": { "published": true } }, { "id": "4175", "type": "proposal", "attributes": { "created_at": "2026-08-05T07:08:02Z", "updated_at": "2026-08-05T07:08:02Z", "title": { "en": " Pariatur perferendis non. 9631", "fr": " Corrupti eos ipsa. 9632" }, "body": { "en": "

Dignissimos repudiandae vitae. 9634

", "fr": "

Quidem temporibus est. 9635

" } }, "relationships": { "space": { "data": { "id": "2482", "type": "participatory_processes" } }, "component": { "data": { "id": "8004", "type": "proposal_component" } }, "state": { "data": { "id": "5556", "type": "proposal_state" }, "meta": { "token": "rejected" } }, "author": { "data": { "id": "5365", "type": "user" } }, "coauthors": { "data": [ { "id": "5365", "type": "user" } ], "meta": { "count": 1 } } }, "links": { "related": { "href": "https://144.lvh.me/public/components/8004", "title": " Proposals", "rel": "resource", "meta": { "space_id": "2482", "space_manifest": "participatory_processes", "component_id": "8004", "component_manifest": "proposals", "action_method": "GET" } }, "self": { "href": "https://144.lvh.me/api/rest_full/v0.3/proposals/4175", "title": "Proposals Details", "rel": "resource", "meta": { "component_id": "8004", "component_manifest": "proposals", "space_id": "2482", "space_manifest": "participatory_processes", "resource_id": "4175", "action_method": "GET" } }, "collection": { "href": "https://144.lvh.me/api/rest_full/v0.3/proposals", "title": "Proposals List", "rel": "resource", "meta": { "component_id": "8004", "component_manifest": "proposals", "space_id": "2482", "space_manifest": "participatory_processes", "resource_id": "4175", "action_method": "GET" } } }, "meta": { "published": true } }, { "id": "4176", "type": "proposal", "attributes": { "created_at": "2026-08-05T07:08:02Z", "updated_at": "2026-08-05T07:08:02Z", "title": { "en": " Non consectetur sit. 9644", "fr": " Inventore natus vitae. 9645" }, "body": { "en": "

In nemo earum. 9647

", "fr": "

Est repellat non. 9648

" } }, "relationships": { "space": { "data": { "id": "2482", "type": "participatory_processes" } }, "component": { "data": { "id": "8004", "type": "proposal_component" } }, "author": { "data": { "id": "5366", "type": "user" } }, "coauthors": { "data": [ { "id": "5366", "type": "user" } ], "meta": { "count": 1 } } }, "links": { "related": { "href": "https://144.lvh.me/public/components/8004", "title": " Proposals", "rel": "resource", "meta": { "space_id": "2482", "space_manifest": "participatory_processes", "component_id": "8004", "component_manifest": "proposals", "action_method": "GET" } }, "self": { "href": "https://144.lvh.me/api/rest_full/v0.3/proposals/4176", "title": "Proposals Details", "rel": "resource", "meta": { "component_id": "8004", "component_manifest": "proposals", "space_id": "2482", "space_manifest": "participatory_processes", "resource_id": "4176", "action_method": "GET" } }, "collection": { "href": "https://144.lvh.me/api/rest_full/v0.3/proposals", "title": "Proposals List", "rel": "resource", "meta": { "component_id": "8004", "component_manifest": "proposals", "space_id": "2482", "space_manifest": "participatory_processes", "resource_id": "4176", "action_method": "GET" } } }, "meta": { "published": true } }, { "id": "4177", "type": "proposal", "attributes": { "created_at": "2026-08-05T07:08:03Z", "updated_at": "2026-08-05T07:08:03Z", "title": { "en": " Delectus aut facilis. 9657", "fr": " Odio doloribus illo. 9658" }, "body": { "en": "

Omnis natus facilis. 9660

", "fr": "

Iure voluptatem rerum. 9661

" } }, "relationships": { "space": { "data": { "id": "2482", "type": "participatory_processes" } }, "component": { "data": { "id": "8004", "type": "proposal_component" } }, "author": { "data": { "id": "5367", "type": "user" } }, "coauthors": { "data": [ { "id": "5367", "type": "user" } ], "meta": { "count": 1 } } }, "links": { "related": { "href": "https://144.lvh.me/public/components/8004", "title": " Proposals", "rel": "resource", "meta": { "space_id": "2482", "space_manifest": "participatory_processes", "component_id": "8004", "component_manifest": "proposals", "action_method": "GET" } }, "self": { "href": "https://144.lvh.me/api/rest_full/v0.3/proposals/4177", "title": "Proposals Details", "rel": "resource", "meta": { "component_id": "8004", "component_manifest": "proposals", "space_id": "2482", "space_manifest": "participatory_processes", "resource_id": "4177", "action_method": "GET" } }, "collection": { "href": "https://144.lvh.me/api/rest_full/v0.3/proposals", "title": "Proposals List", "rel": "resource", "meta": { "component_id": "8004", "component_manifest": "proposals", "space_id": "2482", "space_manifest": "participatory_processes", "resource_id": "4177", "action_method": "GET" } } }, "meta": { "published": true } }, { "id": "4178", "type": "proposal", "attributes": { "created_at": "2026-08-05T07:08:03Z", "updated_at": "2026-08-05T07:08:03Z", "title": { "en": " Sed at excepturi. 9670", "fr": " Dolor voluptas esse. 9671" }, "body": { "en": "

Fugit quas aut. 9673

", "fr": "

Id quidem nulla. 9674

" } }, "relationships": { "space": { "data": { "id": "2482", "type": "participatory_processes" } }, "component": { "data": { "id": "8004", "type": "proposal_component" } }, "state": { "data": { "id": "5555", "type": "proposal_state" }, "meta": { "token": "accepted" } }, "author": { "data": { "id": "5368", "type": "user" } }, "coauthors": { "data": [ { "id": "5368", "type": "user" } ], "meta": { "count": 1 } } }, "links": { "related": { "href": "https://144.lvh.me/public/components/8004", "title": " Proposals", "rel": "resource", "meta": { "space_id": "2482", "space_manifest": "participatory_processes", "component_id": "8004", "component_manifest": "proposals", "action_method": "GET" } }, "self": { "href": "https://144.lvh.me/api/rest_full/v0.3/proposals/4178", "title": "Proposals Details", "rel": "resource", "meta": { "component_id": "8004", "component_manifest": "proposals", "space_id": "2482", "space_manifest": "participatory_processes", "resource_id": "4178", "action_method": "GET" } }, "collection": { "href": "https://144.lvh.me/api/rest_full/v0.3/proposals", "title": "Proposals List", "rel": "resource", "meta": { "component_id": "8004", "component_manifest": "proposals", "space_id": "2482", "space_manifest": "participatory_processes", "resource_id": "4178", "action_method": "GET" } } }, "meta": { "published": true, "voted": { "weight": 1 } } }, { "id": "4179", "type": "proposal", "attributes": { "created_at": "2026-08-05T07:08:03Z", "updated_at": "2026-08-05T07:08:03Z", "title": { "en": " A accusantium et. 9683", "fr": " Ipsum consequatur iusto. 9684" }, "body": { "en": "

Sit doloribus quia. 9686

", "fr": "

Enim ad voluptas. 9687

" } }, "relationships": { "space": { "data": { "id": "2482", "type": "participatory_processes" } }, "component": { "data": { "id": "8004", "type": "proposal_component" } }, "author": { "data": { "id": "5362", "type": "user" } }, "coauthors": { "data": [ { "id": "5362", "type": "user" } ], "meta": { "count": 1 } } }, "links": { "related": { "href": "https://144.lvh.me/public/components/8004", "title": " Proposals", "rel": "resource", "meta": { "space_id": "2482", "space_manifest": "participatory_processes", "component_id": "8004", "component_manifest": "proposals", "action_method": "GET" } }, "self": { "href": "https://144.lvh.me/api/rest_full/v0.3/proposals/4179", "title": "Proposals Details", "rel": "resource", "meta": { "component_id": "8004", "component_manifest": "proposals", "space_id": "2482", "space_manifest": "participatory_processes", "resource_id": "4179", "action_method": "GET" } }, "collection": { "href": "https://144.lvh.me/api/rest_full/v0.3/proposals", "title": "Proposals List", "rel": "resource", "meta": { "component_id": "8004", "component_manifest": "proposals", "space_id": "2482", "space_manifest": "participatory_processes", "resource_id": "4179", "action_method": "GET" } } }, "meta": { "published": false } } ] } }, "paginated": { "value": { "data": [ { "id": "4207", "type": "proposal", "attributes": { "created_at": "2026-08-05T07:08:13Z", "updated_at": "2026-08-05T07:08:13Z", "title": { "en": " Officia magnam sed. 10645", "fr": " Nihil ratione omnis. 10646" }, "body": { "en": "

Velit iste esse. 10648

", "fr": "

Asperiores delectus unde. 10649

" } }, "relationships": { "space": { "data": { "id": "2493", "type": "participatory_processes" } }, "component": { "data": { "id": "8015", "type": "proposal_component" } }, "state": { "data": { "id": "5588", "type": "proposal_state" }, "meta": { "token": "accepted" } }, "author": { "data": { "id": "5401", "type": "user" } }, "coauthors": { "data": [ { "id": "5401", "type": "user" } ], "meta": { "count": 1 } } }, "links": { "related": { "href": "https://155.lvh.me/public/components/8015", "title": " Proposals", "rel": "resource", "meta": { "space_id": "2493", "space_manifest": "participatory_processes", "component_id": "8015", "component_manifest": "proposals", "action_method": "GET" } }, "self": { "href": "https://155.lvh.me/api/rest_full/v0.3/proposals/4207", "title": "Proposals Details", "rel": "resource", "meta": { "component_id": "8015", "component_manifest": "proposals", "space_id": "2493", "space_manifest": "participatory_processes", "resource_id": "4207", "action_method": "GET" } }, "collection": { "href": "https://155.lvh.me/api/rest_full/v0.3/proposals", "title": "Proposals List", "rel": "resource", "meta": { "component_id": "8015", "component_manifest": "proposals", "space_id": "2493", "space_manifest": "participatory_processes", "resource_id": "4207", "action_method": "GET" } } }, "meta": { "published": true } }, { "id": "4208", "type": "proposal", "attributes": { "created_at": "2026-08-05T07:08:13Z", "updated_at": "2026-08-05T07:08:13Z", "title": { "en": " Maxime dolor quas. 10658", "fr": " Atque ut sed. 10659" }, "body": { "en": "

Dolores maiores sed. 10661

", "fr": "

Autem qui sint. 10662

" } }, "relationships": { "space": { "data": { "id": "2493", "type": "participatory_processes" } }, "component": { "data": { "id": "8015", "type": "proposal_component" } }, "state": { "data": { "id": "5588", "type": "proposal_state" }, "meta": { "token": "accepted" } }, "author": { "data": { "id": "5402", "type": "user" } }, "coauthors": { "data": [ { "id": "5402", "type": "user" } ], "meta": { "count": 1 } } }, "links": { "related": { "href": "https://155.lvh.me/public/components/8015", "title": " Proposals", "rel": "resource", "meta": { "space_id": "2493", "space_manifest": "participatory_processes", "component_id": "8015", "component_manifest": "proposals", "action_method": "GET" } }, "self": { "href": "https://155.lvh.me/api/rest_full/v0.3/proposals/4208", "title": "Proposals Details", "rel": "resource", "meta": { "component_id": "8015", "component_manifest": "proposals", "space_id": "2493", "space_manifest": "participatory_processes", "resource_id": "4208", "action_method": "GET" } }, "collection": { "href": "https://155.lvh.me/api/rest_full/v0.3/proposals", "title": "Proposals List", "rel": "resource", "meta": { "component_id": "8015", "component_manifest": "proposals", "space_id": "2493", "space_manifest": "participatory_processes", "resource_id": "4208", "action_method": "GET" } } }, "meta": { "published": true } } ] } }, "filter_by_extended_data_miss": { "value": { "data": [] } } }, "schema": { "$ref": "#/components/schemas/proposal_index_response" } } } }, "401": { "description": "Unauthorized when no Bearer token", "content": { "application/json": { "examples": { "unauthorized": { "value": { "error": "401: Unauthorized access", "error_description": "Unauthorized access" } } }, "schema": { "$ref": "#/components/schemas/error_response" } } } } } } }, "/roles/sync": { "post": { "summary": "Create role", "tags": [ "Roles" ], "operationId": "createRole", "description": "Create a role (general_admin or space_*). Mutates Decidim state (User admin, ParticipatoryProcessUserRole, AssemblyUserRole, AssemblyMember).", "parameters": [ { "name": "Authorization", "in": "header", "schema": { "type": "string" }, "required": false, "description": "Bearer access token (see security schemes)" } ], "security": [ { "credentialFlowBearer": [ "roles" ] } ], "responses": { "403": { "description": "Forbidden", "content": { "application/json": { "examples": { "forbidden_credentialFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } } }, "schema": { "$ref": "#/components/schemas/error_response" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } }, "201": { "description": "Role created (space_private_member) - participatory_processes", "content": { "application/json": { "examples": { "space_moderator_ok_assemblies": { "value": { "data": { "id": "eyJyZXNvdXJjZV90eXBlIjoiRGVjaWRpbTo6QXNzZW1ibHkiLCJyZXNvdXJjZV9pZCI6MTkyNywidXNlcl9pZCI6NTQyMywiaW52aXRlZF9hdCI6bnVsbCwidHlwZSI6InNwYWNlX21vZGVyYXRvciJ9", "type": "role", "attributes": { "type": "space_moderator", "user_id": 5423, "resource_id": 1927, "resource_type": "Decidim::Assembly", "invited_at": null, "accepted_invite": true, "created_at": "2026-08-05T07:08:26Z", "updated_at": "2026-08-05T07:08:26Z" } } } }, "space_administrator_ok_assemblies": { "value": { "data": { "id": "eyJyZXNvdXJjZV90eXBlIjoiRGVjaWRpbTo6QXNzZW1ibHkiLCJyZXNvdXJjZV9pZCI6MTkyOCwidXNlcl9pZCI6NTQyNCwiaW52aXRlZF9hdCI6bnVsbCwidHlwZSI6InNwYWNlX2FkbWluaXN0cmF0b3IifQ", "type": "role", "attributes": { "type": "space_administrator", "user_id": 5424, "resource_id": 1928, "resource_type": "Decidim::Assembly", "invited_at": null, "accepted_invite": true, "created_at": "2026-08-05T07:08:27Z", "updated_at": "2026-08-05T07:08:27Z" } } } }, "space_valuator_ok_assemblies": { "value": { "data": { "id": "eyJyZXNvdXJjZV90eXBlIjoiRGVjaWRpbTo6QXNzZW1ibHkiLCJyZXNvdXJjZV9pZCI6MTkyOSwidXNlcl9pZCI6NTQyNSwiaW52aXRlZF9hdCI6bnVsbCwidHlwZSI6InNwYWNlX3ZhbHVhdG9yIn0", "type": "role", "attributes": { "type": "space_valuator", "user_id": 5425, "resource_id": 1929, "resource_type": "Decidim::Assembly", "invited_at": null, "accepted_invite": true, "created_at": "2026-08-05T07:08:27Z", "updated_at": "2026-08-05T07:08:27Z" } } } }, "space_private_member_ok_assemblies": { "value": { "data": { "id": "eyJyZXNvdXJjZV90eXBlIjoiRGVjaWRpbTo6QXNzZW1ibHkiLCJyZXNvdXJjZV9pZCI6MTkzMCwidXNlcl9pZCI6NTQyNiwiaW52aXRlZF9hdCI6bnVsbCwidHlwZSI6InNwYWNlX3ByaXZhdGVfbWVtYmVyIn0", "type": "role", "attributes": { "type": "space_private_member", "user_id": 5426, "resource_id": 1930, "resource_type": "Decidim::Assembly", "invited_at": null, "accepted_invite": true, "created_at": "2026-08-05T07:08:27Z", "updated_at": "2026-08-05T07:08:27Z" } } } }, "space_administrator_ok_conferences": { "value": { "data": { "id": "eyJyZXNvdXJjZV90eXBlIjoiRGVjaWRpbTo6Q29uZmVyZW5jZSIsInJlc291cmNlX2lkIjo1NywidXNlcl9pZCI6NTQyNywiaW52aXRlZF9hdCI6bnVsbCwidHlwZSI6InNwYWNlX2FkbWluaXN0cmF0b3IifQ", "type": "role", "attributes": { "type": "space_administrator", "user_id": 5427, "resource_id": 57, "resource_type": "Decidim::Conference", "invited_at": null, "accepted_invite": true, "created_at": "2026-08-05T07:08:27Z", "updated_at": "2026-08-05T07:08:27Z" } } } }, "space_valuator_ok_conferences": { "value": { "data": { "id": "eyJyZXNvdXJjZV90eXBlIjoiRGVjaWRpbTo6Q29uZmVyZW5jZSIsInJlc291cmNlX2lkIjo1OCwidXNlcl9pZCI6NTQyOCwiaW52aXRlZF9hdCI6bnVsbCwidHlwZSI6InNwYWNlX3ZhbHVhdG9yIn0", "type": "role", "attributes": { "type": "space_valuator", "user_id": 5428, "resource_id": 58, "resource_type": "Decidim::Conference", "invited_at": null, "accepted_invite": true, "created_at": "2026-08-05T07:08:27Z", "updated_at": "2026-08-05T07:08:27Z" } } } }, "space_private_member_ok_conferences": { "value": { "data": { "id": "eyJyZXNvdXJjZV90eXBlIjoiRGVjaWRpbTo6Q29uZmVyZW5jZSIsInJlc291cmNlX2lkIjo1OSwidXNlcl9pZCI6NTQyOSwiaW52aXRlZF9hdCI6bnVsbCwidHlwZSI6InNwYWNlX3ByaXZhdGVfbWVtYmVyIn0", "type": "role", "attributes": { "type": "space_private_member", "user_id": 5429, "resource_id": 59, "resource_type": "Decidim::Conference", "invited_at": null, "accepted_invite": true, "created_at": "2026-08-05T07:08:28Z", "updated_at": "2026-08-05T07:08:28Z" } } } }, "space_moderator_ok_conferences": { "value": { "data": { "id": "eyJyZXNvdXJjZV90eXBlIjoiRGVjaWRpbTo6Q29uZmVyZW5jZSIsInJlc291cmNlX2lkIjo2MCwidXNlcl9pZCI6NTQzMCwiaW52aXRlZF9hdCI6bnVsbCwidHlwZSI6InNwYWNlX21vZGVyYXRvciJ9", "type": "role", "attributes": { "type": "space_moderator", "user_id": 5430, "resource_id": 60, "resource_type": "Decidim::Conference", "invited_at": null, "accepted_invite": true, "created_at": "2026-08-05T07:08:28Z", "updated_at": "2026-08-05T07:08:28Z" } } } }, "general_admin_ok": { "value": { "data": { "id": "eyJyZXNvdXJjZV90eXBlIjoiRGVjaWRpbTo6T3JnYW5pemF0aW9uIiwicmVzb3VyY2VfaWQiOjE1ODcsInVzZXJfaWQiOjU0MzIsImludml0ZWRfYXQiOm51bGwsInR5cGUiOiJnZW5lcmFsX2FkbWluIn0", "type": "role", "attributes": { "type": "general_admin", "user_id": 5432, "resource_id": 1587, "resource_type": "Decidim::Organization", "invited_at": null, "accepted_invite": true, "created_at": "2026-08-05T07:08:28Z", "updated_at": "2026-08-05T07:08:29Z" } } } }, "space_moderator_ok_participatory_processes": { "value": { "data": { "id": "eyJyZXNvdXJjZV90eXBlIjoiRGVjaWRpbTo6UGFydGljaXBhdG9yeVByb2Nlc3MiLCJyZXNvdXJjZV9pZCI6MjUwNywidXNlcl9pZCI6NTQzMywiaW52aXRlZF9hdCI6bnVsbCwidHlwZSI6InNwYWNlX21vZGVyYXRvciJ9", "type": "role", "attributes": { "type": "space_moderator", "user_id": 5433, "resource_id": 2507, "resource_type": "Decidim::ParticipatoryProcess", "invited_at": null, "accepted_invite": true, "created_at": "2026-08-05T07:08:29Z", "updated_at": "2026-08-05T07:08:29Z" } } } }, "space_administrator_ok_participatory_processes": { "value": { "data": { "id": "eyJyZXNvdXJjZV90eXBlIjoiRGVjaWRpbTo6UGFydGljaXBhdG9yeVByb2Nlc3MiLCJyZXNvdXJjZV9pZCI6MjUwOCwidXNlcl9pZCI6NTQzNCwiaW52aXRlZF9hdCI6bnVsbCwidHlwZSI6InNwYWNlX2FkbWluaXN0cmF0b3IifQ", "type": "role", "attributes": { "type": "space_administrator", "user_id": 5434, "resource_id": 2508, "resource_type": "Decidim::ParticipatoryProcess", "invited_at": null, "accepted_invite": true, "created_at": "2026-08-05T07:08:29Z", "updated_at": "2026-08-05T07:08:29Z" } } } }, "space_valuator_ok_participatory_processes": { "value": { "data": { "id": "eyJyZXNvdXJjZV90eXBlIjoiRGVjaWRpbTo6UGFydGljaXBhdG9yeVByb2Nlc3MiLCJyZXNvdXJjZV9pZCI6MjUwOSwidXNlcl9pZCI6NTQzNSwiaW52aXRlZF9hdCI6bnVsbCwidHlwZSI6InNwYWNlX3ZhbHVhdG9yIn0", "type": "role", "attributes": { "type": "space_valuator", "user_id": 5435, "resource_id": 2509, "resource_type": "Decidim::ParticipatoryProcess", "invited_at": null, "accepted_invite": true, "created_at": "2026-08-05T07:08:29Z", "updated_at": "2026-08-05T07:08:29Z" } } } }, "space_private_member_ok_participatory_processes": { "value": { "data": { "id": "eyJyZXNvdXJjZV90eXBlIjoiRGVjaWRpbTo6UGFydGljaXBhdG9yeVByb2Nlc3MiLCJyZXNvdXJjZV9pZCI6MjUxMCwidXNlcl9pZCI6NTQzNiwiaW52aXRlZF9hdCI6bnVsbCwidHlwZSI6InNwYWNlX3ByaXZhdGVfbWVtYmVyIn0", "type": "role", "attributes": { "type": "space_private_member", "user_id": 5436, "resource_id": 2510, "resource_type": "Decidim::ParticipatoryProcess", "invited_at": null, "accepted_invite": true, "created_at": "2026-08-05T07:08:30Z", "updated_at": "2026-08-05T07:08:30Z" } } } } } } } }, "422": { "description": "Validation error", "content": { "application/json": { "examples": { "invalid_type": { "value": { "errors": [ { "title": "Invalid role type: invalid_type" } ] } } } } } } }, "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "attributes": { "type": "object", "properties": { "resource_type": { "type": "string", "enum": [ "Decidim::ParticipatoryProcess", "Decidim::Assembly", "Decidim::Conference", "Decidim::Initiative", "Decidim::Organization" ] }, "resource_id": { "type": "integer" }, "user_id": { "type": "integer" }, "type": { "type": "string", "enum": [ "general_admin", "space_private_member", "space_administrator", "space_moderator", "space_valuator" ] } }, "required": [ "resource_type", "resource_id", "user_id", "type" ] } }, "required": [ "attributes" ] } }, "required": [ "data" ] } } }, "required": true } } }, "/spaces/participatory_processes/{id}/extended_data": { "get": { "summary": "Space extended data", "tags": [ "Spaces" ], "operationId": "getSpaceExtendedData", "description": "See [Extended data](https://octree-gva.github.io/decidim-rest-full/integrator/extended-data).", "parameters": [ { "name": "object_path", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "schema": { "type": "string" }, "required": true }, { "name": "Authorization", "in": "header", "schema": { "type": "string" }, "required": false, "description": "Bearer access token (see security schemes)" } ], "security": [ { "credentialFlowBearer": [ "public" ] } ], "responses": { "403": { "description": "Forbidden", "content": { "application/json": { "examples": { "forbidden_credentialFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } } }, "schema": { "$ref": "#/components/schemas/error_response" } } } }, "200": { "description": "Extended data", "content": { "application/json": { "examples": { "ok": { "value": { "data": { "zone": "north" } } } }, "schema": { "$ref": "#/components/schemas/resource_extended_data" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } } } } }, "/spaces/participatory_processes/{id}/extended_data/sync": { "put": { "summary": "Set space extended data (sync)", "tags": [ "Spaces" ], "operationId": "setSpaceExtendedData", "description": "See [Extended data](https://octree-gva.github.io/decidim-rest-full/integrator/extended-data).", "parameters": [ { "name": "object_path", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "schema": { "type": "string" }, "required": true }, { "name": "Authorization", "in": "header", "schema": { "type": "string" }, "required": false, "description": "Bearer access token (see security schemes)" } ], "security": [ { "credentialFlowBearer": [ "public" ] } ], "responses": { "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" }, "examples": { "forbidden_credentialFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } } } } } }, "200": { "description": "Updated", "content": { "application/json": { "examples": { "ok": { "value": { "data": { "zone": "south" } } } }, "schema": { "$ref": "#/components/schemas/resource_extended_data" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } } }, "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "additionalProperties": true } }, "required": [ "data" ] } } }, "required": true } } }, "/questionnaires": { "get": { "summary": "Questionnaires index", "tags": [ "Forms" ], "security": [ { "credentialFlowBearer": [ "surveys" ] } ], "operationId": "listQuestionnaires", "parameters": [ { "name": "page", "in": "query", "description": "Page number for pagination", "required": false, "schema": { "type": "integer" } }, { "name": "per_page", "in": "query", "description": "Number of items per page", "required": false, "schema": { "type": "integer" } }, { "name": "Authorization", "in": "header", "schema": { "type": "string" }, "required": false, "description": "Bearer access token (see security schemes)" } ], "responses": { "403": { "description": "Forbidden", "content": { "application/json": { "examples": { "forbidden_credentialFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } } }, "schema": { "$ref": "#/components/schemas/error_response" } } } }, "200": { "description": "Questionnaires list", "content": { "application/json": { "examples": { "ok": { "value": { "data": [ { "id": "2819", "type": "questionnaires", "attributes": { "title": " Ea ducimus ut. 12856", "description": "

Dolorum iste corrupti. 12859

", "updated_at": "2026-08-05T07:08:50Z" }, "links": { "self": { "href": "https://196.lvh.me/api/questionnaires/2819", "rel": "self", "meta": { "action_method": "GET" } }, "submit": { "href": "https://196.lvh.me/api/answers", "rel": "submit", "meta": { "action_method": "POST", "questionnaire_id": "2819" } }, "submit_sync": { "href": "https://196.lvh.me/api/answers/sync", "rel": "submit_sync", "meta": { "action_method": "POST" } }, "questions": { "href": "https://196.lvh.me/api/questions?filter[questionnaire_id]=2819", "rel": "questions", "meta": { "action_method": "GET" } } }, "meta": { "locale": "en", "requested_locale": "en", "fallback_from": null } } ] } } }, "schema": { "$ref": "#/components/schemas/questionnaire_index_response" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } } } } }, "/organizations": { "get": { "summary": "Organizations", "tags": [ "Organizations" ], "operationId": "listOrganizations", "description": "List available organizations", "parameters": [ { "name": "locales[]", "in": "query", "style": "form", "explode": true, "schema": { "type": "array", "title": "Available locales", "description": "List of locale codes the organization exposes.", "items": { "$ref": "#/components/schemas/locale" } }, "required": false }, { "name": "page", "in": "query", "description": "Page number for pagination", "required": false, "schema": { "type": "integer" } }, { "name": "per_page", "in": "query", "description": "Number of items per page", "required": false, "schema": { "type": "integer" } }, { "name": "Authorization", "in": "header", "schema": { "type": "string" }, "required": false, "description": "Bearer access token (see security schemes)" } ], "security": [ { "credentialFlowBearer": [ "system" ] } ], "responses": { "401": { "description": "Unauthorized when no Bearer token", "content": { "application/json": { "examples": { "unauthorized": { "value": { "error": "401: Unauthorized access", "error_description": "Unauthorized access" } } }, "schema": { "$ref": "#/components/schemas/error_response" } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "examples": { "forbidden_credentialFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } } }, "schema": { "$ref": "#/components/schemas/error_response" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } }, "200": { "description": "Organizations listed", "content": { "application/json": { "examples": { "ok": { "value": { "data": [ { "id": "1610", "type": "organization", "attributes": { "host": "215.lvh.me", "secondary_hosts": [], "default_locale": "en", "available_locales": [ "en" ], "enable_machine_translations": false, "badges_enabled": true, "rich_text_editor_in_public_views": false, "comments_max_length": 1000, "time_zone": "UTC", "users_registration_mode": "enabled", "force_users_to_authenticate_before_access_organization": false, "reference_prefix": "LLD", "send_welcome_notification": true, "enable_participatory_space_filters": false, "user_groups_enabled": false, "name": { "en": "Bins-Dibbert", "fr": "Morissette-Carter" }, "description": { "en": "

Omnis cum similique. 13720

", "fr": "

Omnis quasi in. 13721

" }, "extended_data": {}, "created_at": "2026-08-05T07:08:59Z", "updated_at": "2026-08-05T07:08:59Z" }, "meta": { "locales": [ "en", "fr" ] } } ] } } }, "schema": { "$ref": "#/components/schemas/organization_index_response" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } } } } }, "/webhook_registrations": { "post": { "summary": "Create webhook registration", "tags": [ "Webhooks" ], "operationId": "createWebhookRegistration", "description": "Create a webhook registration for the current API client.\nThe signing secret is returned **only in this response** — store it to verify HMAC signatures.\nSubscriptions must be event permissions already granted on the API client.\n", "parameters": [ { "name": "Authorization", "in": "header", "schema": { "type": "string" }, "required": false, "description": "Bearer access token (see security schemes)" } ], "security": [ { "credentialFlowBearer": [ "webhooks" ] } ], "responses": { "400": { "description": "Invalid subscription", "content": { "application/json": { "examples": { "bad_request": { "value": { "error": "400: Bad request", "error_description": "Subscriptions Subscription to not.an.event is not allowed" } } }, "schema": { "$ref": "#/components/schemas/error_response" } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "examples": { "forbidden_credentialFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } } }, "schema": { "$ref": "#/components/schemas/error_response" } } } }, "201": { "description": "Registration created", "content": { "application/json": { "examples": { "ok": { "value": { "data": { "id": "30", "type": "webhook_registration", "attributes": { "url": "https://example.org/hooks/new", "subscriptions": [ "proposal_creation.succeeded" ], "signing_secret": "dbd3bee4818c8b01714a31faaf195471a4039ddd7323c7481b0e48b20fc30b6d", "created_at": "2026-08-05T07:09:08Z", "updated_at": "2026-08-05T07:09:08Z" } } } } }, "schema": { "$ref": "#/components/schemas/webhook_registration_item_response" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } } }, "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/webhook_registration_create_body" } } }, "required": true } }, "get": { "summary": "List webhook registrations", "tags": [ "Webhooks" ], "operationId": "listWebhookRegistrations", "description": "List webhook registrations owned by the current API client.", "parameters": [ { "name": "page", "in": "query", "description": "Page number for pagination", "required": false, "schema": { "type": "integer" } }, { "name": "per_page", "in": "query", "description": "Number of items per page", "required": false, "schema": { "type": "integer" } }, { "name": "Authorization", "in": "header", "schema": { "type": "string" }, "required": false, "description": "Bearer access token (see security schemes)" } ], "security": [ { "credentialFlowBearer": [ "webhooks" ] } ], "responses": { "403": { "description": "Forbidden", "content": { "application/json": { "examples": { "forbidden_credentialFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } } }, "schema": { "$ref": "#/components/schemas/error_response" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } }, "200": { "description": "Registrations listed", "content": { "application/json": { "examples": { "ok": { "value": { "data": [ { "id": "43", "type": "webhook_registration", "attributes": { "url": "https://example.org/hooks/mine", "subscriptions": [ "proposal_creation.succeeded" ], "created_at": "2026-08-05T07:27:29Z", "updated_at": "2026-08-05T07:27:29Z" } } ] } } }, "schema": { "$ref": "#/components/schemas/webhook_registration_index_response" } } } } } } }, "/organizations/{id}/extended_data": { "get": { "summary": "Organization extended data", "tags": [ "Organizations Extended Data" ], "operationId": "getOrganizationExtendedData", "description": "Fetch organization extended data", "parameters": [ { "name": "object_path", "in": "query", "required": true, "schema": { "type": "string", "description": "object path, in dot style, like foo.bar" } }, { "name": "id", "in": "path", "schema": { "type": "integer", "description": "Id of the organization" }, "required": true }, { "name": "Authorization", "in": "header", "schema": { "type": "string" }, "required": false, "description": "Bearer access token (see security schemes)" } ], "security": [ { "credentialFlowBearer": [ "system" ] } ], "responses": { "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "examples": { "forbidden_credentialFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } } }, "schema": { "$ref": "#/components/schemas/error_response" } } } }, "200": { "description": "Extended Data for a given object_path given", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/organization_extended_data" }, "examples": { "ok": { "value": { "data": { "personal": { "birthday": "1989-01-28" }, "birthday": "1989-01-28" } } }, "empty": { "value": { "data": {} } } } } } } } } }, "/oauth/token": { "post": { "summary": "Request a OAuth token through Client Credentials", "tags": [ "OAuth" ], "security": [], "operationId": "createToken", "description": "Create a oauth token for the given scopes", "parameters": [], "responses": { "200": { "description": "Token returned", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/oauth_token_response" }, "examples": { "ok_ropc_login": { "value": { "access_token": "-z57twZOgIUVqk3lutO3C09f63YD4OCJbIRj9UCyG0k", "token_type": "Bearer", "expires_in": 7200, "scope": "public proposals", "created_at": 1785913769 } }, "ok_ropc_impersonate": { "value": { "access_token": "Gf_vzEInEMM9FCt4g8f-p8BBqzS4yLAXH_lzJ_c3jNw", "token_type": "Bearer", "expires_in": 7200, "scope": "public", "created_at": 1785913770 } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "examples": { "invalid_grant_type": { "value": { "error": "400: Bad request", "error_description": "Doorkeeper::Errors::InvalidTokenStrategy" } }, "bad_request": { "value": { "error": "400: Bad request", "error_description": "Invalid Api Client, check credentials" } }, "user_not_found": { "value": { "error": "400: Bad request", "error_description": "User not found. To create one, user meta.register_on_missing" } }, "invalid_username_on_register": { "value": { "error": "400: Bad request", "error_description": "User not found. To create one, user meta.register_on_missing" } } }, "schema": { "$ref": "#/components/schemas/error_response" } } } } }, "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/oauth_grant_param" } } }, "required": true } } }, "/answers/sync": { "post": { "summary": "Submit answers synchronously", "tags": [ "Forms" ], "security": [ { "credentialFlowBearer": [ "surveys" ] } ], "operationId": "createAnswers", "parameters": [ { "name": "Authorization", "in": "header", "schema": { "type": "string" }, "required": false, "description": "Bearer access token (see security schemes)" } ], "responses": { "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } }, "201": { "description": "Created questionnaire response", "content": { "application/json": { "examples": { "created": { "value": { "data": { "id": "14", "type": "questionnaire_response", "attributes": { "answers": { "185": "Test answer", "186": null, "187": null }, "client_ip": "120488698348784059647353" }, "relationships": { "questionnaire": { "data": { "id": "2824", "type": "questionnaires" } } }, "links": { "self": { "href": "https://247.lvh.me/api/questionnaire_responses/14", "rel": "self", "meta": { "action_method": "GET" } } }, "meta": { "locale": "en", "requested_locale": "en", "fallback_from": null, "user": null, "created_at": "2026-08-05T07:09:41Z" } } } } }, "schema": { "$ref": "#/components/schemas/questionnaire_response_item_response" } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "examples": { "forbidden_credentialFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } } }, "schema": { "$ref": "#/components/schemas/error_response" } } } } }, "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/questionnaire_answers_create_body" } } }, "required": true } } }, "/meetings": { "get": { "summary": "Meetings", "tags": [ "Meetings" ], "operationId": "listMeetings", "description": "List published meetings. Filter with `filter[extended_data_cont]` when the client has `meetings.extended_data.read`.\n\nSee [Extended data](https://octree-gva.github.io/decidim-rest-full/integrator/extended-data).\n", "parameters": [ { "name": "locales[]", "in": "query", "style": "form", "explode": true, "schema": { "type": "array", "title": "Available locales", "description": "List of locale codes the organization exposes.", "items": { "$ref": "#/components/schemas/locale" } }, "required": false }, { "name": "page", "in": "query", "description": "Page number for pagination", "required": false, "schema": { "type": "integer" } }, { "name": "per_page", "in": "query", "description": "Number of items per page", "required": false, "schema": { "type": "integer" } }, { "name": "space_manifest", "in": "query", "schema": { "type": "string", "enum": [ "participatory_processes", "assemblies", "conferences", "initiatives" ], "description": "Space type" }, "required": false }, { "name": "space_id", "in": "query", "schema": { "type": "integer", "description": "Space Id" }, "required": false }, { "name": "component_id", "in": "query", "schema": { "type": "integer", "description": "Component Id" }, "required": false }, { "name": "order", "in": "query", "schema": { "type": "string", "enum": [ "start_time", "rand" ] }, "description": "Order by", "required": false }, { "name": "order_direction", "in": "query", "schema": { "type": "string", "enum": [ "asc", "desc" ] }, "description": "Order direction", "required": false }, { "name": "filter[extended_data_cont]", "in": "query", "schema": { "type": "string" }, "required": false, "description": "Search on meeting extended_data. Format: `\"\":\"\"`" }, { "name": "Authorization", "in": "header", "schema": { "type": "string" }, "required": false, "description": "Bearer access token (see security schemes)" } ], "security": [ { "resourceOwnerFlowBearer": [ "meetings" ] } ], "responses": { "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" }, "examples": { "forbidden_credentialFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } }, "filter_extended_data_forbidden": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } }, "forbidden_impersonationFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } }, "200": { "description": "Meeting List", "content": { "application/json": { "examples": { "filter_by_extended_data": { "value": { "data": [ { "id": "2772", "type": "meeting", "attributes": { "created_at": "2026-08-05T07:09:57Z", "updated_at": "2026-08-05T07:09:57Z", "extended_data": { "integration": "alpha" } }, "relationships": { "space": { "data": { "id": "2539", "type": "participatory_processes" } }, "component": { "data": { "id": "8041", "type": "meeting_component" } } }, "links": { "related": { "href": "https://280.lvh.me/public/components/8041", "title": " Meetings", "rel": "resource", "meta": { "space_id": "2539", "space_manifest": "participatory_processes", "component_id": "8041", "component_manifest": "meetings", "action_method": "GET" } }, "self": { "href": "https://280.lvh.me/api/rest_full/v0.3/meetings/2772", "title": "Meetings Details", "rel": "resource", "meta": { "component_id": "8041", "component_manifest": "meetings", "space_id": "2539", "space_manifest": "participatory_processes", "resource_id": "2772", "action_method": "GET" } }, "collection": { "href": "https://280.lvh.me/api/rest_full/v0.3/meetings", "title": "Meetings List", "rel": "resource", "meta": { "component_id": "8041", "component_manifest": "meetings", "space_id": "2539", "space_manifest": "participatory_processes", "resource_id": "2772", "action_method": "GET" } } } } ] } }, "filter_by_extended_data_miss": { "value": { "data": [] } }, "ok": { "value": { "data": [ { "id": "2771", "type": "meeting", "attributes": { "created_at": "2026-08-05T07:09:57Z", "updated_at": "2026-08-05T07:09:57Z" }, "relationships": { "space": { "data": { "id": "2538", "type": "participatory_processes" } }, "component": { "data": { "id": "8040", "type": "meeting_component" } } }, "links": { "related": { "href": "https://278.lvh.me/public/components/8040", "title": " Meetings", "rel": "resource", "meta": { "space_id": "2538", "space_manifest": "participatory_processes", "component_id": "8040", "component_manifest": "meetings", "action_method": "GET" } }, "self": { "href": "https://278.lvh.me/api/rest_full/v0.3/meetings/2771", "title": "Meetings Details", "rel": "resource", "meta": { "component_id": "8040", "component_manifest": "meetings", "space_id": "2538", "space_manifest": "participatory_processes", "resource_id": "2771", "action_method": "GET" } }, "collection": { "href": "https://278.lvh.me/api/rest_full/v0.3/meetings", "title": "Meetings List", "rel": "resource", "meta": { "component_id": "8040", "component_manifest": "meetings", "space_id": "2538", "space_manifest": "participatory_processes", "resource_id": "2771", "action_method": "GET" } } } } ] } } }, "schema": { "$ref": "#/components/schemas/meeting_index_response" } } } } } } }, "/vote_proposals/sync": { "post": { "summary": "Vote on a proposal (sync)", "tags": [ "Proposals" ], "operationId": "castProposalVote", "description": "Cast a vote synchronously. Returns a **vote_proposal** resource by default.\n\nSet query `include_proposal=true` to return the full **proposal** payload (heavier).\n", "parameters": [ { "name": "include_proposal", "in": "query", "schema": { "type": "boolean" }, "required": false, "description": "When true, return the full proposal instead of the vote resource" }, { "name": "Authorization", "in": "header", "schema": { "type": "string" }, "required": false, "description": "Bearer access token (see security schemes)" } ], "security": [ { "resourceOwnerFlowBearer": [ "proposals" ] } ], "responses": { "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" }, "examples": { "forbidden_impersonationFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } } } } } }, "400": { "description": "Bad Request when user already voted", "content": { "application/json": { "examples": { "already_voted": { "value": { "error": "400: Bad request", "error_description": "Already voted" } } }, "schema": { "$ref": "#/components/schemas/error_response" } } } }, "200": { "description": "Vote created with full proposal", "content": { "application/json": { "examples": { "default": { "value": { "data": { "id": "84", "type": "vote_proposals", "attributes": { "weight": 1, "created_at": "2026-08-05T07:10:17Z", "updated_at": "2026-08-05T07:10:17Z" }, "relationships": { "proposal": { "data": { "id": "4228", "type": "proposals" } }, "author": { "data": { "id": "5464", "type": "users" } } } } } }, "with_proposal": { "value": { "data": { "id": "4230", "type": "proposal", "attributes": { "created_at": "2026-08-05T07:10:18Z", "updated_at": "2026-08-05T07:10:18Z", "title": { "en": " Necessitatibus ut voluptatem. 17328", "fr": " Similique molestiae delectus. 17329" }, "body": { "en": "

Sit quia ipsa. 17331

", "fr": "

Reiciendis qui debitis. 17332

" } }, "relationships": { "space": { "data": { "id": "2550", "type": "participatory_processes" } }, "component": { "data": { "id": "8052", "type": "proposal_component" } }, "author": { "data": { "id": "5469", "type": "user" } }, "coauthors": { "data": [ { "id": "5469", "type": "user" } ], "meta": { "count": 1 } } }, "links": { "related": { "href": "https://298.lvh.me/public/components/8052", "title": " Proposals", "rel": "resource", "meta": { "space_id": "2550", "space_manifest": "participatory_processes", "component_id": "8052", "component_manifest": "proposals", "action_method": "GET" } }, "self": { "href": "https://298.lvh.me/api/rest_full/v0.3/proposals/4230", "title": "Proposals Details", "rel": "resource", "meta": { "component_id": "8052", "component_manifest": "proposals", "space_id": "2550", "space_manifest": "participatory_processes", "resource_id": "4230", "action_method": "GET" } }, "collection": { "href": "https://298.lvh.me/api/rest_full/v0.3/proposals", "title": "Proposals List", "rel": "resource", "meta": { "component_id": "8052", "component_manifest": "proposals", "space_id": "2550", "space_manifest": "participatory_processes", "resource_id": "4230", "action_method": "GET" } } }, "meta": { "published": true, "voted": { "weight": 1 } } } } } }, "schema": { "$ref": "#/components/schemas/proposal_item_response" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } } }, "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/vote_proposal_create_body" } } }, "required": true } } }, "/vote_proposals/{id}": { "get": { "summary": "Show vote proposal", "tags": [ "Proposals" ], "operationId": "getProposalVote", "description": "Fetch a single vote by id. Conditional GET supported.", "parameters": [ { "name": "id", "in": "path", "schema": { "type": "integer" }, "required": true }, { "name": "Authorization", "in": "header", "schema": { "type": "string" }, "required": false, "description": "Bearer access token (see security schemes)" } ], "security": [ { "resourceOwnerFlowBearer": [ "proposals" ] } ], "responses": { "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } }, "200": { "description": "Vote found", "content": { "application/json": { "examples": { "ok": { "value": { "data": { "id": "87", "type": "vote_proposals", "attributes": { "weight": 1, "created_at": "2026-08-05T07:10:20Z", "updated_at": "2026-08-05T07:10:20Z" }, "relationships": { "proposal": { "data": { "id": "4232", "type": "proposals" } }, "author": { "data": { "id": "5472", "type": "users" } } } } } } }, "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/vote_proposal" } } } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" }, "examples": { "forbidden_impersonationFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } } } } } } } }, "delete": { "summary": "Remove vote on a proposal", "tags": [ "Proposals" ], "operationId": "deleteProposalVote", "description": "Remove the impersonated user's vote (`Decidim::Proposals::UnvoteProposal`). Returns the vote resource.", "parameters": [ { "name": "id", "in": "path", "schema": { "type": "integer" }, "required": true }, { "name": "Authorization", "in": "header", "schema": { "type": "string" }, "required": false, "description": "Bearer access token (see security schemes)" } ], "security": [ { "resourceOwnerFlowBearer": [ "proposals" ] } ], "responses": { "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "examples": { "forbidden_impersonationFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } } }, "schema": { "$ref": "#/components/schemas/error_response" } } } }, "200": { "description": "Vote removed", "content": { "application/json": { "examples": { "ok": { "value": { "data": { "id": "93", "type": "vote_proposals", "attributes": { "weight": 1, "created_at": "2026-08-05T07:10:25Z", "updated_at": "2026-08-05T07:10:25Z" }, "relationships": { "proposal": { "data": { "id": "4238", "type": "proposals" } }, "author": { "data": { "id": "5484", "type": "users" } } } } } } } } } } } } }, "/vote_proposals": { "post": { "summary": "Vote on a proposal (async)", "tags": [ "Proposals" ], "operationId": "castProposalVoteAsync", "description": "Enqueue a vote on a **published** proposal. Poll `GET /jobs/:uuid` for the result (slim vote payload by default).\n\nPrefer this endpoint under load. Use `POST /vote_proposals/sync` when you need an immediate response.\n", "parameters": [ { "name": "Authorization", "in": "header", "schema": { "type": "string" }, "required": false, "description": "Bearer access token (see security schemes)" } ], "security": [ { "resourceOwnerFlowBearer": [ "proposals" ] } ], "responses": { "202": { "description": "Job accepted", "content": { "application/json": { "examples": { "accepted": { "value": { "job_id": "05b26abc-b44a-47a7-ad0a-beeb635eff31", "status": "pending", "data": null, "return_value": null, "poll_url": "https://307.lvh.me/api/rest_full/v0.3/jobs/05b26abc-b44a-47a7-ad0a-beeb635eff31", "links": { "self": { "href": "https://307.lvh.me/api/rest_full/v0.3/jobs/05b26abc-b44a-47a7-ad0a-beeb635eff31", "title": "API job status", "rel": "resource", "meta": { "action_method": "GET" } } } } } }, "schema": { "$ref": "#/components/schemas/rest_full_api_job_accepted" } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "examples": { "forbidden_impersonationFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } } }, "schema": { "$ref": "#/components/schemas/error_response" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } } }, "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/vote_proposal_create_body" } } }, "required": true } }, "get": { "summary": "List vote proposals", "tags": [ "Proposals" ], "operationId": "listProposalVotes", "description": "List `Decidim::Proposals::ProposalVote` rows for published proposals in visible spaces.\n\n### Filters\n- `filter[creator_id]` (or `filter[author_id]`): voter user id\n- `filter[proposal_id]`: proposal id\n- `filter[component_id]`: proposals component id\n- `filter[participatory_space_id]`: participatory space id\n\nResponses support **conditional GET** (`ETag` / `If-None-Match`).\n\n### Access\nRequires impersonation (`proposals.vote` or `proposals.read` for listing).\n", "parameters": [ { "name": "page", "in": "query", "description": "Page number for pagination", "required": false, "schema": { "type": "integer" } }, { "name": "per_page", "in": "query", "description": "Number of items per page", "required": false, "schema": { "type": "integer" } }, { "name": "filter[creator_id_in][]", "in": "query", "style": "form", "explode": true, "schema": { "type": "array", "items": { "type": "integer" }, "title": "creator_id IN filter", "description": "match one of _creator_id_'s values in array" }, "required": false }, { "name": "filter[creator_id_eq]", "in": "query", "schema": { "type": "integer", "title": "creator_id equal filter", "description": "_creator_id_ is equal to" }, "required": false }, { "name": "filter[creator_id_lt]", "in": "query", "schema": { "type": "integer", "title": "creator_id less than filter", "description": "_creator_id_ is less than" }, "required": false }, { "name": "filter[creator_id_gt]", "in": "query", "schema": { "type": "integer", "title": "creator_id greater than filter", "description": "_creator_id_ is greater than" }, "required": false }, { "name": "filter[creator_id_present]", "in": "query", "schema": { "type": "boolean", "title": "creator_id present filter", "description": "_creator_id_ is not null and not empty" }, "required": false }, { "name": "filter[creator_id_blank]", "in": "query", "schema": { "type": "boolean", "title": "creator_id blank filter", "description": "_creator_id_ is null or empty" }, "required": false }, { "name": "filter[proposal_id_in][]", "in": "query", "style": "form", "explode": true, "schema": { "type": "array", "items": { "type": "integer" }, "title": "proposal_id IN filter", "description": "match one of _proposal_id_'s values in array" }, "required": false }, { "name": "filter[proposal_id_eq]", "in": "query", "schema": { "type": "integer", "title": "proposal_id equal filter", "description": "_proposal_id_ is equal to" }, "required": false }, { "name": "filter[proposal_id_lt]", "in": "query", "schema": { "type": "integer", "title": "proposal_id less than filter", "description": "_proposal_id_ is less than" }, "required": false }, { "name": "filter[proposal_id_gt]", "in": "query", "schema": { "type": "integer", "title": "proposal_id greater than filter", "description": "_proposal_id_ is greater than" }, "required": false }, { "name": "filter[proposal_id_present]", "in": "query", "schema": { "type": "boolean", "title": "proposal_id present filter", "description": "_proposal_id_ is not null and not empty" }, "required": false }, { "name": "filter[proposal_id_blank]", "in": "query", "schema": { "type": "boolean", "title": "proposal_id blank filter", "description": "_proposal_id_ is null or empty" }, "required": false }, { "name": "filter[component_id_in][]", "in": "query", "style": "form", "explode": true, "schema": { "type": "array", "items": { "type": "integer" }, "title": "component_id IN filter", "description": "match one of _component_id_'s values in array" }, "required": false }, { "name": "filter[component_id_eq]", "in": "query", "schema": { "type": "integer", "title": "component_id equal filter", "description": "_component_id_ is equal to" }, "required": false }, { "name": "filter[component_id_lt]", "in": "query", "schema": { "type": "integer", "title": "component_id less than filter", "description": "_component_id_ is less than" }, "required": false }, { "name": "filter[component_id_gt]", "in": "query", "schema": { "type": "integer", "title": "component_id greater than filter", "description": "_component_id_ is greater than" }, "required": false }, { "name": "filter[component_id_present]", "in": "query", "schema": { "type": "boolean", "title": "component_id present filter", "description": "_component_id_ is not null and not empty" }, "required": false }, { "name": "filter[component_id_blank]", "in": "query", "schema": { "type": "boolean", "title": "component_id blank filter", "description": "_component_id_ is null or empty" }, "required": false }, { "name": "filter[participatory_space_id_in][]", "in": "query", "style": "form", "explode": true, "schema": { "type": "array", "items": { "type": "integer" }, "title": "participatory_space_id IN filter", "description": "match one of _participatory_space_id_'s values in array" }, "required": false }, { "name": "filter[participatory_space_id_eq]", "in": "query", "schema": { "type": "integer", "title": "participatory_space_id equal filter", "description": "_participatory_space_id_ is equal to" }, "required": false }, { "name": "filter[participatory_space_id_lt]", "in": "query", "schema": { "type": "integer", "title": "participatory_space_id less than filter", "description": "_participatory_space_id_ is less than" }, "required": false }, { "name": "filter[participatory_space_id_gt]", "in": "query", "schema": { "type": "integer", "title": "participatory_space_id greater than filter", "description": "_participatory_space_id_ is greater than" }, "required": false }, { "name": "filter[participatory_space_id_present]", "in": "query", "schema": { "type": "boolean", "title": "participatory_space_id present filter", "description": "_participatory_space_id_ is not null and not empty" }, "required": false }, { "name": "filter[participatory_space_id_blank]", "in": "query", "schema": { "type": "boolean", "title": "participatory_space_id blank filter", "description": "_participatory_space_id_ is null or empty" }, "required": false }, { "name": "Authorization", "in": "header", "schema": { "type": "string" }, "required": false, "description": "Bearer access token (see security schemes)" } ], "security": [ { "resourceOwnerFlowBearer": [ "proposals" ] } ], "responses": { "403": { "description": "Forbidden", "content": { "application/json": { "examples": { "forbidden_impersonationFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } } }, "schema": { "$ref": "#/components/schemas/error_response" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } }, "200": { "description": "Votes listed", "content": { "application/json": { "examples": { "ok": { "value": { "data": [ { "id": "97", "type": "vote_proposals", "attributes": { "weight": 1, "created_at": "2026-08-05T07:10:31Z", "updated_at": "2026-08-05T07:10:31Z" }, "relationships": { "proposal": { "data": { "id": "4246", "type": "proposals" } }, "author": { "data": { "id": "5500", "type": "users" } } } } ] } } }, "schema": { "$ref": "#/components/schemas/vote_proposals_index_response" } } } } } } }, "/questionnaires/{id}": { "get": { "summary": "Questionnaire", "tags": [ "Forms" ], "security": [ { "credentialFlowBearer": [ "surveys" ] } ], "operationId": "getQuestionnaire", "parameters": [ { "name": "id", "in": "path", "schema": { "type": "integer" }, "required": true }, { "name": "Authorization", "in": "header", "schema": { "type": "string" }, "required": false, "description": "Bearer access token (see security schemes)" } ], "responses": { "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" }, "examples": { "forbidden_credentialFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } } } } } }, "200": { "description": "Questionnaire with schema and ui", "content": { "application/json": { "examples": { "ok": { "value": { "data": { "id": "2846", "type": "questionnaires", "attributes": { "title": " Ipsam voluptatem suscipit. 18967", "description": "

In culpa quia. 18970

", "schema": { "type": "object", "properties": { "203": { "type": "string", "title": " Consequatur recusandae odit. 18976" }, "204": { "type": "string", "title": " Qui minus maiores. 19027" }, "205": { "type": "string", "title": " Nulla qui quo. 19078", "enum": [ "202", "203", "204" ] } }, "required": [] }, "ui": { "type": "VerticalLayout", "elements": [ { "type": "Control", "scope": "#/properties/203", "label": " Consequatur recusandae odit. 18976" }, { "type": "Control", "scope": "#/properties/204", "label": " Qui minus maiores. 19027" }, { "type": "Control", "scope": "#/properties/205", "label": " Nulla qui quo. 19078", "options": { "choices": [ { "id": "202", "translations": { "en": "Quaerat ipsum qui. 19129", "fr": "Illo odio sit. 19130", "machine_translations": { "es": "Qui voluptates aut. 19131" } } }, { "id": "203", "translations": { "en": "Nulla cupiditate sapiente. 19132", "fr": "Error quam voluptatem. 19133", "machine_translations": { "es": "Quasi laudantium explicabo. 19134" } } }, { "id": "204", "translations": { "en": "Rem pariatur non. 19135", "fr": "Tempore eius itaque. 19136", "machine_translations": { "es": "Est blanditiis repudiandae. 19137" } } } ] } } ] }, "updated_at": "2026-08-05T07:10:47Z" }, "links": { "self": { "href": "https://324.lvh.me/api/questionnaires/2846", "rel": "self", "meta": { "action_method": "GET" } }, "submit": { "href": "https://324.lvh.me/api/answers", "rel": "submit", "meta": { "action_method": "POST", "questionnaire_id": "2846" } }, "submit_sync": { "href": "https://324.lvh.me/api/answers/sync", "rel": "submit_sync", "meta": { "action_method": "POST" } }, "questions": { "href": "https://324.lvh.me/api/questions?filter[questionnaire_id]=2846", "rel": "questions", "meta": { "action_method": "GET" } } }, "meta": { "locale": "en", "requested_locale": "en", "fallback_from": null, "submission": { "allows_anonymous": true, "requires_participant_ip": true } } } } } }, "schema": { "$ref": "#/components/schemas/questionnaire_item_response" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } } } }, "put": { "summary": "Update questionnaire metadata (async)", "tags": [ "Forms" ], "security": [ { "credentialFlowBearer": [ "surveys" ] } ], "operationId": "updateQuestionnaireAsync", "description": "Enqueue questionnaire metadata update (title, description, terms of service). Poll `GET /jobs/:uuid`.", "parameters": [ { "name": "id", "in": "path", "schema": { "type": "integer" }, "required": true }, { "name": "Authorization", "in": "header", "schema": { "type": "string" }, "required": false, "description": "Bearer access token (see security schemes)" } ], "responses": { "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" }, "examples": { "forbidden_credentialFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } }, "202": { "description": "Job accepted", "content": { "application/json": { "examples": { "accepted": { "value": { "job_id": "91ab1a31-58af-4835-b7bf-c6705a025240", "status": "pending", "data": null, "return_value": null, "poll_url": "https://494.lvh.me/api/rest_full/v0.3/jobs/91ab1a31-58af-4835-b7bf-c6705a025240", "links": { "self": { "href": "https://494.lvh.me/api/rest_full/v0.3/jobs/91ab1a31-58af-4835-b7bf-c6705a025240", "title": "API job status", "rel": "resource", "meta": { "action_method": "GET" } } } } } }, "schema": { "$ref": "#/components/schemas/rest_full_api_job_accepted" } } } } }, "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/questionnaire_update_body" } } }, "required": true } } }, "/components/proposal_components/{id}": { "get": { "summary": "Proposal Component Details", "tags": [ "Components" ], "operationId": "showProposalComponent", "description": "Find on proposal", "parameters": [ { "name": "locales[]", "in": "query", "style": "form", "explode": true, "schema": { "type": "array", "title": "Available locales", "description": "List of locale codes the organization exposes.", "items": { "$ref": "#/components/schemas/locale" } }, "required": false }, { "name": "page", "in": "query", "description": "Page number for pagination", "required": false, "schema": { "type": "integer" } }, { "name": "per_page", "in": "query", "description": "Number of items per page", "required": false, "schema": { "type": "integer" } }, { "name": "filter[id_in][]", "in": "query", "style": "form", "explode": true, "schema": { "type": "array", "items": { "type": "integer" }, "title": "id IN filter", "description": "match one of _id_'s values in array" }, "required": false }, { "name": "filter[id_eq]", "in": "query", "schema": { "type": "integer", "title": "id equal filter", "description": "_id_ is equal to" }, "required": false }, { "name": "filter[id_lt]", "in": "query", "schema": { "type": "integer", "title": "id less than filter", "description": "_id_ is less than" }, "required": false }, { "name": "filter[id_gt]", "in": "query", "schema": { "type": "integer", "title": "id greater than filter", "description": "_id_ is greater than" }, "required": false }, { "name": "filter[id_present]", "in": "query", "schema": { "type": "boolean", "title": "id present filter", "description": "_id_ is not null and not empty" }, "required": false }, { "name": "filter[id_blank]", "in": "query", "schema": { "type": "boolean", "title": "id blank filter", "description": "_id_ is null or empty" }, "required": false }, { "name": "id", "in": "path", "schema": { "type": "integer" }, "required": true }, { "name": "Authorization", "in": "header", "schema": { "type": "string" }, "required": false, "description": "Bearer access token (see security schemes)" } ], "security": [ { "credentialFlowBearer": [ "public" ] } ], "responses": { "403": { "description": "Forbidden", "content": { "application/json": { "examples": { "forbidden_credentialFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } }, "forbidden_impersonationFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } } }, "schema": { "$ref": "#/components/schemas/error_response" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } }, "200": { "description": "Proposal Component", "content": { "application/json": { "examples": { "ok": { "value": { "data": { "id": "8084", "type": "proposal_component", "attributes": { "manifest_name": "proposals", "participatory_space_type": "Decidim::ParticipatoryProcess", "participatory_space_id": "2582", "name": { "en": " Accusamus neque molestiae. 20592", "fr": " Sed dolore accusamus. 20593" }, "global_announcement": {}, "created_at": "2026-08-05T07:11:00Z", "updated_at": "2026-08-05T07:11:00Z" }, "relationships": { "resources": { "data": [], "meta": { "count": 0 } } }, "links": { "self": { "href": "https://345.lvh.me/components/proposal_components/8084", "title": " Accusamus neque molestiae. 20592", "rel": "resource", "meta": { "space_id": "2582", "space_manifest": "participatory_processes", "action_method": "GET" } }, "related": { "href": "https://345.lvh.me/spaces/participatory_processes/2582", "title": " Aperiam sit modi. 20556", "rel": "resource", "meta": { "space_id": "2582", "space_manifest": "participatory_processes", "action_method": "GET" } } }, "meta": { "published": true, "scopes_enabled": false, "amendments_enabled": false, "attachments_allowed": false, "comments_enabled": true, "comments_max_length": 1000, "default_sort_order": "default", "geocoding_enabled": false, "minimum_votes_per_user": 0, "official_proposals_enabled": true, "participatory_texts_enabled": false, "proposal_edit_time": "limited", "proposal_limit": 0, "resources_permissions_enabled": true, "threshold_per_proposal": 0, "vote_limit": 0, "collaborative_drafts_enabled": false, "proposal_edit_before_minutes": 5, "votes_enabled": false, "creation_enabled": false, "proposal_answering_enabled": true, "amendment_creation_enabled": true, "amendment_reaction_enabled": true, "amendment_promotion_enabled": true, "endorsements_enabled": true, "can_create_proposals": false, "can_vote": false, "can_endorse": true, "can_comment": true } } } }, "ok_with_draft": { "value": { "data": { "id": "8088", "type": "proposal_component", "attributes": { "manifest_name": "proposals", "participatory_space_type": "Decidim::ParticipatoryProcess", "participatory_space_id": "2585", "name": { "en": " Iusto consequatur porro. 20912", "fr": " Qui minus dignissimos. 20913" }, "global_announcement": {}, "created_at": "2026-08-05T07:11:01Z", "updated_at": "2026-08-05T07:11:01Z" }, "relationships": { "resources": { "data": [ { "id": "4249", "type": "proposal" } ], "meta": { "count": 1 } } }, "links": { "self": { "href": "https://347.lvh.me/components/proposal_components/8088", "title": " Iusto consequatur porro. 20912", "rel": "resource", "meta": { "space_id": "2585", "space_manifest": "participatory_processes", "action_method": "GET" } }, "related": { "href": "https://347.lvh.me/spaces/participatory_processes/2585", "title": " Optio eum ut. 20819", "rel": "resource", "meta": { "space_id": "2585", "space_manifest": "participatory_processes", "action_method": "GET" } }, "draft": { "href": "https://347.lvh.me/api/rest_full/v0.3/draft_proposals/4249", "title": "Draft Details", "rel": "resource", "meta": { "component_id": "8088", "component_manifest": "proposals", "space_id": "2585", "space_manifest": "participatory_processes", "resource_id": "4249", "action_method": "GET" } } }, "meta": { "published": true, "scopes_enabled": false, "amendments_enabled": false, "attachments_allowed": false, "comments_enabled": true, "comments_max_length": 1000, "default_sort_order": "default", "geocoding_enabled": false, "minimum_votes_per_user": 0, "official_proposals_enabled": true, "participatory_texts_enabled": false, "proposal_edit_time": "limited", "proposal_limit": 0, "resources_permissions_enabled": true, "threshold_per_proposal": 0, "vote_limit": 0, "collaborative_drafts_enabled": false, "proposal_edit_before_minutes": 5, "votes_enabled": false, "creation_enabled": false, "proposal_answering_enabled": true, "amendment_creation_enabled": true, "amendment_reaction_enabled": true, "amendment_promotion_enabled": true, "endorsements_enabled": true, "can_create_proposals": false, "can_vote": false, "can_endorse": true, "can_comment": true } } } } }, "schema": { "$ref": "#/components/schemas/proposal_component_item_response" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } } } } }, "/attachments": { "get": { "summary": "List attachments", "tags": [ "Attachments" ], "operationId": "listAttachments", "parameters": [ { "name": "page", "in": "query", "description": "Page number for pagination", "required": false, "schema": { "type": "integer" } }, { "name": "per_page", "in": "query", "description": "Number of items per page", "required": false, "schema": { "type": "integer" } }, { "name": "filter[attached_to_type_not_in][]", "in": "query", "style": "form", "explode": true, "schema": { "type": "array", "items": { "type": "string" }, "title": "attached_to_type not IN filter", "description": "match none of _attached_to_type_'s values in array" }, "required": false }, { "name": "filter[attached_to_type_in][]", "in": "query", "style": "form", "explode": true, "schema": { "type": "array", "items": { "type": "string" }, "title": "attached_to_type IN filter", "description": "match one of _attached_to_type_'s values in array" }, "required": false }, { "name": "filter[attached_to_type_start]", "in": "query", "schema": { "type": "string", "description": "_attached_to_type_ starts with", "title": "attached_to_type starts With filter", "example": "some_string" }, "required": false }, { "name": "filter[attached_to_type_eq]", "in": "query", "schema": { "type": "string", "title": "attached_to_type equal filter", "description": "_attached_to_type_ is equal to" }, "required": false }, { "name": "filter[attached_to_type_not_eq]", "in": "query", "schema": { "type": "string", "title": "attached_to_type not equal filter", "description": "_attached_to_type_ is NOT equal to" }, "required": false }, { "name": "filter[attached_to_type_matches]", "in": "query", "schema": { "type": "string", "title": "attached_to_type like filter", "description": "matches _attached_to_type_ with `LIKE`", "example": "%some_string" }, "required": false }, { "name": "filter[attached_to_type_blank]", "in": "query", "schema": { "type": "boolean", "title": "attached_to_type blank filter", "description": "_attached_to_type_ is null or empty" }, "required": false }, { "name": "filter[attached_to_id_in][]", "in": "query", "style": "form", "explode": true, "schema": { "type": "array", "items": { "type": "integer" }, "title": "attached_to_id IN filter", "description": "match one of _attached_to_id_'s values in array" }, "required": false }, { "name": "filter[attached_to_id_eq]", "in": "query", "schema": { "type": "integer", "title": "attached_to_id equal filter", "description": "_attached_to_id_ is equal to" }, "required": false }, { "name": "filter[attached_to_id_lt]", "in": "query", "schema": { "type": "integer", "title": "attached_to_id less than filter", "description": "_attached_to_id_ is less than" }, "required": false }, { "name": "filter[attached_to_id_gt]", "in": "query", "schema": { "type": "integer", "title": "attached_to_id greater than filter", "description": "_attached_to_id_ is greater than" }, "required": false }, { "name": "filter[attached_to_id_present]", "in": "query", "schema": { "type": "boolean", "title": "attached_to_id present filter", "description": "_attached_to_id_ is not null and not empty" }, "required": false }, { "name": "filter[attached_to_id_blank]", "in": "query", "schema": { "type": "boolean", "title": "attached_to_id blank filter", "description": "_attached_to_id_ is null or empty" }, "required": false }, { "name": "Authorization", "in": "header", "schema": { "type": "string" }, "required": false, "description": "Bearer access token (see security schemes)" } ], "security": [ { "credentialFlowBearer": [ "attachments" ] } ], "responses": { "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "examples": { "forbidden_credentialFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } } }, "schema": { "$ref": "#/components/schemas/error_response" } } } }, "200": { "description": "Attachments listed", "content": { "application/json": { "examples": { "ok": { "value": { "data": [ { "id": "16", "type": "attachment", "attributes": { "title": { "en": " Labore accusamus aspernatur. 21231", "fr": " Voluptatem quia facere. 21232" }, "description": { "en": " Nostrum nesciunt libero. 21234", "fr": " Animi non quis. 21235" }, "weight": 9, "attachment_collection_id": null, "file_type": "document", "content_type": "application/pdf", "url": null, "thumbnail_url": null, "attached_to": { "type": "Decidim::Proposals::Proposal", "id": 4253 }, "created_at": "2026-08-05T07:11:15Z", "updated_at": "2026-08-05T07:11:15Z" } } ] } } }, "schema": { "$ref": "#/components/schemas/attachment_index_response" } } } } } } }, "/organizations/{id}/sync": { "put": { "summary": "Update organization", "tags": [ "Organizations" ], "operationId": "updateOrganization", "description": "This endpoint allows you to update an organization.\n\n### Update host\nTo update the host, send in your payload the `host` attribute. It will be saved as an `unconfirmed_host` extended data attribute. \nOnce saved, a job will be enqueued to reverse DNS the unconfirmed host before actually updating the host.\nThe `host` attribute must be unique across all organizations.\nMore information on this update process is documented in the [Safe host update](https://octree-gva.github.io/decidim-rest-full/dev/update-hosts) page.\n\n### Update name\nTo update the name, send in your payload the `name` attribute.\nThe `name` attribute must be unique across all organizations.\n", "parameters": [ { "name": "id", "in": "path", "required": true, "description": "The ID of the organization", "schema": { "type": "string" } }, { "name": "Authorization", "in": "header", "schema": { "type": "string" }, "required": false, "description": "Bearer access token (see security schemes)" } ], "security": [ { "credentialFlowBearer": [ "system" ] } ], "responses": { "400": { "description": "Organization Bad Request", "content": { "application/json": { "examples": { "bad_request_name_taken": { "value": { "error": "400: Bad request", "error_description": "Name en has already been taken" } }, "bad_request_host_taken": { "value": { "error": "400: Bad request", "error_description": "Unconfirmed host has already been taken" } } }, "schema": { "$ref": "#/components/schemas/error_response" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } }, "200": { "description": "Organization updated", "content": { "application/json": { "examples": { "ok": { "value": { "data": { "id": "1711", "type": "organization", "attributes": { "host": "362.lvh.me", "secondary_hosts": [], "default_locale": "en", "available_locales": [ "en" ], "enable_machine_translations": false, "badges_enabled": true, "rich_text_editor_in_public_views": false, "comments_max_length": 1000, "time_zone": "UTC", "users_registration_mode": "enabled", "force_users_to_authenticate_before_access_organization": false, "reference_prefix": "MD", "send_welcome_notification": true, "enable_participatory_space_filters": false, "user_groups_enabled": false, "name": { "en": "Braun-Mayert", "fr": "Nom de l'organisation" }, "description": { "en": "

Quod perspiciatis tempora. 21357

", "fr": "

Esse nam error. 21358

" }, "extended_data": {}, "created_at": "2026-08-05T07:11:35Z", "updated_at": "2026-08-05T07:11:35Z" }, "meta": { "locales": [ "en", "fr", "es" ], "unconfirmed_host": "new-host.com" } } } } }, "schema": { "$ref": "#/components/schemas/organization_item_response" } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "examples": { "forbidden_credentialFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } } }, "schema": { "$ref": "#/components/schemas/error_response" } } } }, "404": { "description": "Organization Not Found", "content": { "application/json": { "examples": { "not_found": { "value": { "error": "404: Resource not found", "error_description": "Resource not found" } } }, "schema": { "$ref": "#/components/schemas/error_response" } } } } }, "requestBody": { "content": { "application/json": { "schema": { "type": "object", "title": "Update Organization Payload", "properties": { "data": { "$ref": "#/components/schemas/organization_attributes" } }, "required": [ "data" ] } } }, "required": true } } }, "/roles/{id}": { "get": { "summary": "Show role", "tags": [ "Roles" ], "operationId": "getRole", "description": "Show a single role by id (composite id from Decidim state)", "parameters": [ { "name": "id", "in": "path", "required": true, "description": "The composite role ID (base64url-encoded JSON of resource_type, resource_id, user_id, invited_at, type)", "schema": { "type": "string" } }, { "name": "Authorization", "in": "header", "schema": { "type": "string" }, "required": false, "description": "Bearer access token (see security schemes)" } ], "security": [ { "credentialFlowBearer": [ "roles" ] } ], "responses": { "403": { "description": "Forbidden", "content": { "application/json": { "examples": { "forbidden_credentialFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } } }, "schema": { "$ref": "#/components/schemas/error_response" } } } }, "401": { "description": "Unauthorized when no Bearer token", "content": { "application/json": { "examples": { "unauthorized": { "value": { "error": "401: Unauthorized access", "error_description": "Unauthorized access" } } }, "schema": { "$ref": "#/components/schemas/error_response" } } } }, "200": { "description": "Role shown (space_moderator)", "content": { "application/json": { "examples": { "space_valuator_ok": { "value": { "data": { "id": "eyJyZXNvdXJjZV90eXBlIjoiRGVjaWRpbTo6UGFydGljaXBhdG9yeVByb2Nlc3MiLCJyZXNvdXJjZV9pZCI6MjU5MSwidXNlcl9pZCI6NTUxOCwiaW52aXRlZF9hdCI6bnVsbCwidHlwZSI6InNwYWNlX3ZhbHVhdG9yIn0", "type": "role", "attributes": { "type": "space_valuator", "user_id": 5518, "resource_id": 2591, "resource_type": "Decidim::ParticipatoryProcess", "invited_at": null, "accepted_invite": true, "created_at": "2026-08-05T07:11:44Z", "updated_at": "2026-08-05T07:11:44Z" } } } }, "space_private_member_ok": { "value": { "data": { "id": "eyJyZXNvdXJjZV90eXBlIjoiRGVjaWRpbTo6UGFydGljaXBhdG9yeVByb2Nlc3MiLCJyZXNvdXJjZV9pZCI6MjU5MiwidXNlcl9pZCI6NTUyMCwiaW52aXRlZF9hdCI6bnVsbCwidHlwZSI6InNwYWNlX3ByaXZhdGVfbWVtYmVyIn0", "type": "role", "attributes": { "type": "space_private_member", "user_id": 5520, "resource_id": 2592, "resource_type": "Decidim::ParticipatoryProcess", "invited_at": null, "accepted_invite": true, "created_at": "2026-08-05T07:11:44Z", "updated_at": "2026-08-05T07:11:44Z" } } } }, "space_administrator_ok": { "value": { "data": { "id": "eyJyZXNvdXJjZV90eXBlIjoiRGVjaWRpbTo6UGFydGljaXBhdG9yeVByb2Nlc3MiLCJyZXNvdXJjZV9pZCI6MjU5MywidXNlcl9pZCI6NTUyMywiaW52aXRlZF9hdCI6bnVsbCwidHlwZSI6InNwYWNlX2FkbWluaXN0cmF0b3IifQ", "type": "role", "attributes": { "type": "space_administrator", "user_id": 5523, "resource_id": 2593, "resource_type": "Decidim::ParticipatoryProcess", "invited_at": null, "accepted_invite": true, "created_at": "2026-08-05T07:11:45Z", "updated_at": "2026-08-05T07:11:45Z" } } } }, "general_admin_ok": { "value": { "data": { "id": "eyJyZXNvdXJjZV90eXBlIjoiRGVjaWRpbTo6T3JnYW5pemF0aW9uIiwicmVzb3VyY2VfaWQiOjE3MjYsInVzZXJfaWQiOjU1MjgsImludml0ZWRfYXQiOm51bGwsInR5cGUiOiJnZW5lcmFsX2FkbWluIn0", "type": "role", "attributes": { "type": "general_admin", "user_id": 5528, "resource_id": 1726, "resource_type": "Decidim::Organization", "invited_at": null, "accepted_invite": true, "created_at": "2026-08-05T07:11:46Z", "updated_at": "2026-08-05T07:11:46Z" } } } }, "space_moderator_ok": { "value": { "data": { "id": "eyJyZXNvdXJjZV90eXBlIjoiRGVjaWRpbTo6UGFydGljaXBhdG9yeVByb2Nlc3MiLCJyZXNvdXJjZV9pZCI6MjU5NCwidXNlcl9pZCI6NTUzMCwiaW52aXRlZF9hdCI6bnVsbCwidHlwZSI6InNwYWNlX21vZGVyYXRvciJ9", "type": "role", "attributes": { "type": "space_moderator", "user_id": 5530, "resource_id": 2594, "resource_type": "Decidim::ParticipatoryProcess", "invited_at": null, "accepted_invite": true, "created_at": "2026-08-05T07:11:46Z", "updated_at": "2026-08-05T07:11:46Z" } } } } }, "schema": { "$ref": "#/components/schemas/role_item_response" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } }, "404": { "description": "Role Not Found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" }, "examples": { "not_found_other_org": { "value": { "error": "404: Resource not found", "error_description": "Resource not found" } } } } } } } } }, "/answers": { "post": { "summary": "Submit answers (async)", "tags": [ "Forms" ], "security": [ { "credentialFlowBearer": [ "surveys" ] } ], "operationId": "createAnswersAsync", "description": "Enqueue answer submission; poll GET /submission_requests/:id (202 Accepted).", "parameters": [ { "name": "Authorization", "in": "header", "schema": { "type": "string" }, "required": false, "description": "Bearer access token (see security schemes)" } ], "responses": { "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" }, "examples": { "forbidden_credentialFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } } } } } }, "202": { "description": "Submission request accepted", "content": { "application/json": { "examples": { "accepted": { "value": { "data": { "id": "492618c1-cdcf-4295-9e72-b9c46093cc6e", "type": "submission_request", "attributes": { "status": "pending" }, "links": { "self": { "href": "https://387.lvh.me/api/submission_requests/492618c1-cdcf-4295-9e72-b9c46093cc6e", "rel": "self", "meta": { "action_method": "GET" } } }, "meta": { "status": "pending" } } } } }, "schema": { "$ref": "#/components/schemas/submission_request_accepted_response" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } } }, "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/questionnaire_answers_create_body" } } }, "required": true } } }, "/oauth/introspect": { "post": { "summary": "Introspect an OAuth token", "tags": [ "OAuth" ], "security": [ { "credentialFlowBearer": [ "public" ] }, { "resourceOwnerFlowBearer": [ "public" ] } ], "operationId": "introspectToken", "description": "Check token validity and get optional user/resource (RFC 7662). Send the token to introspect in the request body; use a valid Bearer token in Authorization.", "parameters": [], "responses": { "200": { "description": "User details returned", "content": { "application/json": { "examples": { "bearer_ropc": { "value": { "active": true, "scope": "public", "client_id": "NP3luTEPbMnFKzQRHeUJ3W37XwNQi_by_A4MdLon6Ag", "token_type": "Bearer", "iat": 1785913926, "exp": 3574506252, "sub": 1661, "aud": "https://399.lvh.me", "resource": { "id": "5531", "type": "user", "attributes": { "email": "user431@example.org", "name": "Contessa Hegmann", "created_at": "2026-08-05T07:12:06Z", "updated_at": "2026-08-05T07:12:06Z", "personal_url": "http://harris.test/renetta", "locale": "en" }, "relationships": {}, "meta": { "blocked": false, "locked": false } } } }, "bearer_client_credential": { "value": { "active": true, "scope": "public", "client_id": "E86Iv6Vz8Z4ctOa88LnBe2w_J-QxwYdRPDeXKtzstnQ", "token_type": "Bearer", "iat": 1785913926, "exp": 3574506252, "sub": 1664, "aud": "https://400.lvh.me" } } }, "schema": { "$ref": "#/components/schemas/introspect_data" } } } }, "401": { "description": "When the authorization Bearer token is invalid", "content": { "application/json": { "examples": { "inactive_token": { "value": { "error": "invalid_token", "error_description": "The access token is invalid", "state": "unauthorized" } }, "expired_token": { "value": { "error": "invalid_token", "error_description": "The access token expired", "state": "unauthorized" } } }, "schema": { "$ref": "#/components/schemas/error_response" } } } } }, "requestBody": { "content": { "application/json": { "schema": { "type": "object", "title": "Introspect Token", "properties": { "token": { "type": "string" } }, "required": [ "token" ] } } }, "required": true } } }, "/components/{id}/extended_data": { "get": { "summary": "Component extended data", "tags": [ "Components" ], "operationId": "getComponentExtendedData", "description": "See [Extended data](https://octree-gva.github.io/decidim-rest-full/integrator/extended-data).", "parameters": [ { "name": "object_path", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "schema": { "type": "string" }, "required": true }, { "name": "Authorization", "in": "header", "schema": { "type": "string" }, "required": false, "description": "Bearer access token (see security schemes)" } ], "security": [ { "credentialFlowBearer": [ "public" ] } ], "responses": { "200": { "description": "Extended data", "content": { "application/json": { "examples": { "ok": { "value": { "data": { "a": 1 } } } }, "schema": { "$ref": "#/components/schemas/resource_extended_data" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" }, "examples": { "forbidden_credentialFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } } } } } } } } }, "/components/{id}/extended_data/sync": { "put": { "summary": "Set component extended data (sync)", "tags": [ "Components" ], "operationId": "setComponentExtendedData", "description": "See [Extended data](https://octree-gva.github.io/decidim-rest-full/integrator/extended-data).", "parameters": [ { "name": "object_path", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "schema": { "type": "string" }, "required": true }, { "name": "Authorization", "in": "header", "schema": { "type": "string" }, "required": false, "description": "Bearer access token (see security schemes)" } ], "security": [ { "credentialFlowBearer": [ "public" ] } ], "responses": { "403": { "description": "Forbidden", "content": { "application/json": { "examples": { "forbidden_credentialFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } } }, "schema": { "$ref": "#/components/schemas/error_response" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } }, "200": { "description": "Updated", "content": { "application/json": { "examples": { "ok": { "value": { "data": { "k": "v" } } } }, "schema": { "$ref": "#/components/schemas/resource_extended_data" } } } } }, "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "additionalProperties": true } }, "required": [ "data" ] } } }, "required": true } } }, "/questions": { "post": { "summary": "Create question (async)", "tags": [ "Forms" ], "security": [ { "credentialFlowBearer": [ "surveys" ] } ], "operationId": "createQuestionsAsync", "description": "Enqueue question creation; poll GET /jobs/:uuid.", "parameters": [ { "name": "Authorization", "in": "header", "schema": { "type": "string" }, "required": false, "description": "Bearer access token (see security schemes)" } ], "responses": { "403": { "description": "Forbidden", "content": { "application/json": { "examples": { "forbidden_credentialFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } } }, "schema": { "$ref": "#/components/schemas/error_response" } } } }, "202": { "description": "Job accepted", "content": { "application/json": { "examples": { "accepted": { "value": { "job_id": "518cee73-fc3c-47ef-a1f1-cb299b759cb5", "status": "pending", "data": null, "return_value": null, "poll_url": "https://418.lvh.me/api/rest_full/v0.3/jobs/518cee73-fc3c-47ef-a1f1-cb299b759cb5", "links": { "self": { "href": "https://418.lvh.me/api/rest_full/v0.3/jobs/518cee73-fc3c-47ef-a1f1-cb299b759cb5", "title": "API job status", "rel": "resource", "meta": { "action_method": "GET" } } } } } }, "schema": { "$ref": "#/components/schemas/rest_full_api_job_accepted" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } } }, "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/question_create_body" } } }, "required": true } }, "get": { "summary": "List questions", "tags": [ "Forms" ], "security": [ { "credentialFlowBearer": [ "surveys" ] } ], "operationId": "listQuestions", "description": "List questions for a questionnaire (filter[questionnaire_id] required).", "parameters": [ { "name": "filter[questionnaire_id]", "in": "query", "schema": { "type": "integer" }, "required": true }, { "name": "Authorization", "in": "header", "schema": { "type": "string" }, "required": false, "description": "Bearer access token (see security schemes)" } ], "responses": { "403": { "description": "Forbidden", "content": { "application/json": { "examples": { "forbidden_credentialFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } } }, "schema": { "$ref": "#/components/schemas/error_response" } } } }, "200": { "description": "Questions list", "content": { "application/json": { "examples": { "ok": { "value": { "data": [ { "id": "245", "type": "questions", "attributes": { "position": 0, "mandatory": false, "body": { "en": " Omnis veniam magni. 24881", "fr": " Praesentium quia dolor. 24882", "machine_translations": { "es": " Qui quia architecto. 24883" } }, "description": { "en": "

Itaque iusto laborum. 24884

", "fr": "

Sit voluptate sapiente. 24885

", "machine_translations": { "es": "

Nihil tempora commodi. 24886

" } }, "max_choices": null, "max_characters": 0, "question_type": "short_answer" }, "relationships": { "questionnaire": { "data": { "id": "2860", "type": "questionnaires" } } } }, { "id": "246", "type": "questions", "attributes": { "position": 1, "mandatory": false, "body": { "en": " Aut omnis facilis. 24932", "fr": " Iusto quod similique. 24933", "machine_translations": { "es": " Fugiat culpa consectetur. 24934" } }, "description": { "en": "

Ut delectus consequatur. 24935

", "fr": "

Voluptatem ducimus assumenda. 24936

", "machine_translations": { "es": "

Dolor a quia. 24937

" } }, "max_choices": null, "max_characters": 0, "question_type": "long_answer" }, "relationships": { "questionnaire": { "data": { "id": "2860", "type": "questionnaires" } } } }, { "id": "247", "type": "questions", "attributes": { "position": 2, "mandatory": false, "body": { "en": " Quia explicabo voluptatem. 24983", "fr": " Tenetur at consequatur. 24984", "machine_translations": { "es": " Repellat voluptatem rerum. 24985" } }, "description": { "en": "

Temporibus possimus dolor. 24986

", "fr": "

Ab aperiam enim. 24987

", "machine_translations": { "es": "

Et velit occaecati. 24988

" } }, "max_choices": null, "max_characters": 0, "question_type": "single_option" }, "relationships": { "questionnaire": { "data": { "id": "2860", "type": "questionnaires" } } } } ], "meta": { "locale": "en", "requested_locale": "en", "fallback_from": null } } } }, "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/question" } }, "meta": { "$ref": "#/components/schemas/forms_locale_meta" } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } } } } }, "/questions/sync": { "post": { "summary": "Create question (sync)", "tags": [ "Forms" ], "security": [ { "credentialFlowBearer": [ "surveys" ] } ], "operationId": "createQuestions", "description": "Create a question inline (201).", "parameters": [ { "name": "Authorization", "in": "header", "schema": { "type": "string" }, "required": false, "description": "Bearer access token (see security schemes)" } ], "responses": { "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" }, "examples": { "forbidden_credentialFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } } } } } }, "201": { "description": "Question created", "content": { "application/json": { "examples": { "created": { "value": { "data": { "id": "266", "type": "questions", "attributes": { "position": 99, "mandatory": false, "body": { "en": "API-created question" }, "description": null, "max_choices": null, "max_characters": 0, "question_type": "short_answer" }, "relationships": { "questionnaire": { "data": { "id": "2866", "type": "questionnaires" } } } }, "meta": { "locale": "en", "requested_locale": "en", "fallback_from": null } } } }, "schema": { "$ref": "#/components/schemas/question_item_response" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } } }, "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/question_create_body" } } }, "required": true } } }, "/roles/{id}/sync": { "delete": { "summary": "Destroy role", "tags": [ "Roles" ], "operationId": "deleteRole", "description": "Remove a role (revoke admin, or delete ParticipatoryProcessUserRole/AssemblyUserRole/AssemblyMember). Id is the composite encoded id.", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "Authorization", "in": "header", "schema": { "type": "string" }, "required": false, "description": "Bearer access token (see security schemes)" } ], "security": [ { "credentialFlowBearer": [ "roles" ] } ], "responses": { "204": { "description": "Role destroyed", "content": { "application/json": { "examples": { "ok": { "value": {} } } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" }, "examples": { "forbidden_credentialFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } }, "404": { "description": "Role Not Found", "content": { "application/json": { "examples": { "not_found": { "value": { "error": "404: Resource not found", "error_description": "Resource not found" } } } } } } } } }, "/jobs/{id}": { "delete": { "summary": "Delete API job", "tags": [ "Jobs" ], "operationId": "deleteJob", "description": "Remove a job record from the index. Only jobs created under the same OAuth application and resource owner as the Bearer token may be deleted. Does not cancel Sidekiq work already in flight for `processing` jobs.", "security": [ { "credentialFlowBearer": [ "proposals" ] }, { "resourceOwnerFlowBearer": [ "proposals" ] } ], "parameters": [ { "name": "Authorization", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "204": { "description": "job deleted", "content": { "application/json": { "examples": { "deleted": { "value": {} } } } } } } }, "get": { "summary": "Poll API job", "tags": [ "Jobs" ], "operationId": "getJob", "description": "Poll job status with the UUID from HTTP 202 responses. No Bearer header: capability is solely the opaque UUID scoped by request host / organization.", "security": [], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid", "description": "Job UUID (`job_id` from the asynchronous response body)" } } ], "responses": { "200": { "description": "job state", "content": { "application/json": { "examples": { "poll_completed": { "value": { "id": "9a20bd93-2416-44d9-942c-6374d5c3a17a", "status": "completed", "command_key": "draft_proposals#create", "created_at": "2026-08-05T07:13:54.618Z", "updated_at": "2026-08-05T07:13:54.618Z", "error_class": null, "error_message": null, "data": { "ok": true }, "return_value": { "ok": true }, "links": { "self": { "href": "https://523.lvh.me/api/rest_full/v0.3/jobs/9a20bd93-2416-44d9-942c-6374d5c3a17a", "title": "API job status", "rel": "resource", "meta": { "action_method": "GET" } } } } } }, "schema": { "$ref": "#/components/schemas/rest_full_api_job_detail" } } } }, "404": { "description": "Job not found", "content": { "application/json": { "examples": { "job_unknown_uuid": { "value": { "error": "404: Resource not found", "error_description": "Resource not found" } }, "job_bad_id_shape": { "value": { "error": "404: Resource not found", "error_description": "Resource not found" } } }, "schema": { "$ref": "#/components/schemas/error_response" } } } } } } }, "/questionnaires/{id}/sync": { "put": { "summary": "Update questionnaire metadata (sync)", "tags": [ "Forms" ], "security": [ { "credentialFlowBearer": [ "surveys" ] } ], "operationId": "updateQuestionnaire", "description": "Update questionnaire title, description, or terms of service inline.", "parameters": [ { "name": "id", "in": "path", "schema": { "type": "integer" }, "required": true }, { "name": "Authorization", "in": "header", "schema": { "type": "string" }, "required": false, "description": "Bearer access token (see security schemes)" } ], "responses": { "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" }, "examples": { "forbidden_credentialFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } } } } } }, "200": { "description": "Questionnaire updated", "content": { "application/json": { "examples": { "ok": { "value": { "data": { "id": "2878", "type": "questionnaires", "attributes": { "title": "Updated questionnaire title", "description": "

Qui qui incidunt. 29136

", "schema": { "type": "object", "properties": { "300": { "type": "string", "title": " Molestias maxime animi. 29142" }, "301": { "type": "string", "title": " Id natus eum. 29193" }, "302": { "type": "string", "title": " Et mollitia id. 29244", "enum": [ "298", "299", "300" ] } }, "required": [] }, "ui": { "type": "VerticalLayout", "elements": [ { "type": "Control", "scope": "#/properties/300", "label": " Molestias maxime animi. 29142" }, { "type": "Control", "scope": "#/properties/301", "label": " Id natus eum. 29193" }, { "type": "Control", "scope": "#/properties/302", "label": " Et mollitia id. 29244", "options": { "choices": [ { "id": "298", "translations": { "en": "Eius voluptas optio. 29295", "fr": "Dolor ea quidem. 29296", "machine_translations": { "es": "Harum ea non. 29297" } } }, { "id": "299", "translations": { "en": "Voluptatem tempore cupiditate. 29298", "fr": "Qui quisquam et. 29299", "machine_translations": { "es": "Ut et dolorum. 29300" } } }, { "id": "300", "translations": { "en": "Nam sunt consequatur. 29301", "fr": "Molestias debitis ab. 29302", "machine_translations": { "es": "Et sit rerum. 29303" } } } ] } } ] }, "updated_at": "2026-08-05T07:13:40Z" }, "links": { "self": { "href": "https://518.lvh.me/api/questionnaires/2878", "rel": "self", "meta": { "action_method": "GET" } }, "submit": { "href": "https://518.lvh.me/api/answers", "rel": "submit", "meta": { "action_method": "POST", "questionnaire_id": "2878" } }, "submit_sync": { "href": "https://518.lvh.me/api/answers/sync", "rel": "submit_sync", "meta": { "action_method": "POST" } }, "questions": { "href": "https://518.lvh.me/api/questions?filter[questionnaire_id]=2878", "rel": "questions", "meta": { "action_method": "GET" } } }, "meta": { "locale": "en", "requested_locale": "en", "fallback_from": null, "submission": { "allows_anonymous": true, "requires_participant_ip": true } } } } } } } } } }, "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/questionnaire_update_body" } } }, "required": true } } }, "/organizations/{id}/extended_data/sync": { "put": { "summary": "Update organization extended data", "tags": [ "Organizations Extended Data" ], "operationId": "setOrganizationExtendedData", "description": "The extended_data feature allows you to update a hash with recursive merging. Use the body payload with these keys:\n\n1. `data`: The value or hash you want to update.\n2. `object_path`: The dot-style path to the key (e.g., access.this.key).\n\n**Root path**
\nTo update data from root of the hash, use `object_path=\".\"`.\n\nExample:\n```\n body={\"data\": {\"name\": \"Jane\"}, \"object_path\": \"personnal\"}\n```\nThis recursively merges data into the hash without removing existing keys.\n\n**Merge some data**
\nInitial hash:\n```json\n {\n \"personnal\": {\"birthday\": \"1989-05-18\"}\n }\n```\nPatch payload:\n```json\n {\n \"data\": {\n \"name\": \"Jane\"\n },\n \"object_path\": \"personnal\"\n }\n```\nResult:\n```\n {\n \"personnal\": {\"birthday\": \"1989-05-18\", \"name\": \"Jane\"}\n }\n```\n\n**Create new Paths**
\nPaths are created as needed.\nExemple:\n```json\n body = {\"data\": {\"external_user_id\": 12}, \"object_path\": \"data-store.my-app.foo\"}\n```\nResult:\n```json\n {\n \"personnal\": {\"birthday\": \"1989-05-18\"},\n \"data-store\": {\"my-app\": {\"foo\": {\"external_user_id\": 12}}}\n }\n```\nAlternatively:\n```\n body = {\"data\": 12, \"object_path\": \"data-store.my-app.foo.external_user_id\"}\n```\n\n**Remove a key**
\nSet a key to null or an empty value to remove it.\n\nExample: Initial hash:\n```json\n {\n \"personnal\": {\"birthday\": \"1989-05-18\", \"name\": \"Jane\"}\n }\n```\nPatch:\n```json\n body = {\"data\": {\"birthday\": \"\"}, \"object_path\": \"personnal\"}\n```\n\nResult:\n```\n{\n \"personnal\": {\"name\": \"Jane\"}\n}\n```\n\n**Return Value**
\nThe update request returns the updated value at the specified path.\n\n", "parameters": [ { "name": "id", "in": "path", "schema": { "type": "integer", "description": "Id of the organization" }, "required": true }, { "name": "Authorization", "in": "header", "schema": { "type": "string" }, "required": false, "description": "Bearer access token (see security schemes)" } ], "security": [ { "credentialFlowBearer": [ "system" ] } ], "responses": { "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" }, "examples": { "forbidden_credentialFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } } } } } }, "200": { "description": "Update extended data value", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/organization_extended_data" }, "examples": { "ok": { "value": { "data": { "foo": "bar" } } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } } }, "requestBody": { "content": { "application/json": { "schema": { "type": "object", "title": "User Extended Data Payload", "properties": { "data": { "type": "object", "title": "User Extended Data Data", "description": "New value for the extended data at the given path" }, "object_path": { "type": "string", "description": "object path, in dot style, like foo.bar. use '.' to update the whole user data" } }, "required": [ "data" ] } } }, "required": true } } }, "/spaces/assemblies": { "get": { "summary": "List Assemblies", "tags": [ "Spaces" ], "operationId": "listAssemblies", "description": "List participatory spaces of type Assemblies for the current organization. Supports the same `filter` query parameters as `/spaces/search`, scoped to this space type. Extended data filter: `filter[extended_data_cont]` (requires `public.space.extended_data.read`).", "parameters": [ { "name": "locales[]", "in": "query", "style": "form", "explode": true, "schema": { "type": "array", "title": "Available locales", "description": "List of locale codes the organization exposes.", "items": { "$ref": "#/components/schemas/locale" } }, "required": false }, { "name": "page", "in": "query", "description": "Page number for pagination", "required": false, "schema": { "type": "integer" } }, { "name": "per_page", "in": "query", "description": "Number of items per page", "required": false, "schema": { "type": "integer" } }, { "name": "filter[extended_data_cont]", "in": "query", "schema": { "type": "string" }, "required": false, "description": "Search on space extended_data. See [Extended data](https://octree-gva.github.io/decidim-rest-full/integrator/extended-data)." }, { "name": "Authorization", "in": "header", "schema": { "type": "string" }, "required": false, "description": "Bearer access token (see security schemes)" } ], "security": [ { "resourceOwnerFlowBearer": [ "public" ] } ], "responses": { "401": { "description": "Unauthorized when no Bearer token", "content": { "application/json": { "examples": { "unauthorized": { "value": { "error": "401: Unauthorized access", "error_description": "Unauthorized access" } } }, "schema": { "$ref": "#/components/schemas/error_response" } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "examples": { "forbidden_credentialFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } }, "forbidden_impersonationFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } } }, "schema": { "$ref": "#/components/schemas/error_response" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } }, "200": { "description": "Assemblies list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/space_index_response" }, "examples": { "ok": { "value": { "data": [ { "id": "1979", "type": "space", "attributes": { "manifest_name": "assemblies", "participatory_space_type": "Decidim::Assembly", "title": { "en": "My assembly for testing purpose", "fr": "c'est une assemblée" }, "subtitle": { "en": " Modi qui fugiat. 38058", "fr": " Rerum animi dolor. 38059" }, "short_description": { "en": "

Dolorem tenetur nulla. 38061

", "fr": "

Molestiae consequatur doloribus. 38062

" }, "description": { "en": "

Sed quidem sed. 38064

", "fr": "

Culpa nesciunt consequatur. 38065

" }, "visibility": "transparent", "created_at": "2026-08-05T07:15:08Z", "updated_at": "2026-08-05T07:15:08Z" }, "relationships": { "components": { "data": [ { "id": "8279", "type": "page_component" }, { "id": "8280", "type": "proposal_component" }, { "id": "8281", "type": "meeting_component" }, { "id": "8282", "type": "budget_component" }, { "id": "8283", "type": "survey_component" }, { "id": "8284", "type": "accountability_component" }, { "id": "8285", "type": "debate_component" }, { "id": "8286", "type": "blog_component" }, { "id": "8287", "type": "awesome_map_component" }, { "id": "8288", "type": "awesome_iframe_component" }, { "id": "8289", "type": "proposal_component" }, { "id": "8290", "type": "meeting_component" }, { "id": "8291", "type": "proposal_component" }, { "id": "8292", "type": "meeting_component" }, { "id": "8293", "type": "proposal_component" }, { "id": "8294", "type": "meeting_component" } ], "meta": { "count": 16 }, "links": { "self": { "href": "https://599.lvh.me/api/rest_full/v0.3/public/components?filter[participatory_space_type_eq]=Decidim::Assembly&filter[participatory_space_id_eq]=1979", "title": "Component list for this space", "rel": "resource", "meta": { "space_manifest": "assemblies", "space_id": "1979", "action_method": "GET" } } } } }, "links": { "self": { "href": "https://599.lvh.me/public/assemblies/1979", "title": "en", "rel": "resource", "meta": { "space_id": "1979", "space_manifest": "assemblies", "action_method": "GET" } }, "related": { "href": "https://599.lvh.me/system/organizations/1804", "title": "Deckow-Bradtke", "rel": "resource", "meta": { "action_method": "GET" } } } }, { "id": "1980", "type": "space", "attributes": { "manifest_name": "assemblies", "participatory_space_type": "Decidim::Assembly", "title": { "en": " Labore aperiam reprehenderit. 38217", "fr": " Consequatur veritatis cupiditate. 38218" }, "subtitle": { "en": " Quae magnam et. 38220", "fr": " Dignissimos cumque nisi. 38221" }, "short_description": { "en": "

Quo perferendis animi. 38223

", "fr": "

Ex necessitatibus est. 38224

" }, "description": { "en": "

Asperiores aspernatur blanditiis. 38226

", "fr": "

Optio adipisci omnis. 38227

" }, "visibility": "transparent", "created_at": "2026-08-05T07:15:09Z", "updated_at": "2026-08-05T07:15:09Z" }, "relationships": { "components": { "data": [], "meta": { "count": 0 }, "links": { "self": { "href": "https://599.lvh.me/api/rest_full/v0.3/public/components?filter[participatory_space_type_eq]=Decidim::Assembly&filter[participatory_space_id_eq]=1980", "title": "Component list for this space", "rel": "resource", "meta": { "space_manifest": "assemblies", "space_id": "1980", "action_method": "GET" } } } } }, "links": { "self": { "href": "https://599.lvh.me/public/assemblies/1980", "title": "en", "rel": "resource", "meta": { "space_id": "1980", "space_manifest": "assemblies", "action_method": "GET" } }, "related": { "href": "https://599.lvh.me/system/organizations/1804", "title": "Deckow-Bradtke", "rel": "resource", "meta": { "action_method": "GET" } } } }, { "id": "1981", "type": "space", "attributes": { "manifest_name": "assemblies", "participatory_space_type": "Decidim::Assembly", "title": { "en": " Perspiciatis tempore ullam. 38292", "fr": " Ipsa possimus et. 38293" }, "subtitle": { "en": " Veritatis assumenda accusamus. 38295", "fr": " Autem consequatur et. 38296" }, "short_description": { "en": "

Aut quia eius. 38298

", "fr": "

Dolores dolorem ut. 38299

" }, "description": { "en": "

Quas deleniti fuga. 38301

", "fr": "

Et porro reprehenderit. 38302

" }, "visibility": "transparent", "created_at": "2026-08-05T07:15:09Z", "updated_at": "2026-08-05T07:15:09Z" }, "relationships": { "components": { "data": [], "meta": { "count": 0 }, "links": { "self": { "href": "https://599.lvh.me/api/rest_full/v0.3/public/components?filter[participatory_space_type_eq]=Decidim::Assembly&filter[participatory_space_id_eq]=1981", "title": "Component list for this space", "rel": "resource", "meta": { "space_manifest": "assemblies", "space_id": "1981", "action_method": "GET" } } } } }, "links": { "self": { "href": "https://599.lvh.me/public/assemblies/1981", "title": "en", "rel": "resource", "meta": { "space_id": "1981", "space_manifest": "assemblies", "action_method": "GET" } }, "related": { "href": "https://599.lvh.me/system/organizations/1804", "title": "Deckow-Bradtke", "rel": "resource", "meta": { "action_method": "GET" } } } }, { "id": "1982", "type": "space", "attributes": { "manifest_name": "assemblies", "participatory_space_type": "Decidim::Assembly", "title": { "en": " Sed totam tenetur. 38367", "fr": " Id porro quia. 38368" }, "subtitle": { "en": " Consequatur dolores omnis. 38370", "fr": " Provident ut aperiam. 38371" }, "short_description": { "en": "

Reprehenderit consequatur sapiente. 38373

", "fr": "

Accusantium nisi itaque. 38374

" }, "description": { "en": "

Sapiente aperiam tenetur. 38376

", "fr": "

Perferendis excepturi aliquid. 38377

" }, "visibility": "transparent", "created_at": "2026-08-05T07:15:09Z", "updated_at": "2026-08-05T07:15:09Z" }, "relationships": { "components": { "data": [], "meta": { "count": 0 }, "links": { "self": { "href": "https://599.lvh.me/api/rest_full/v0.3/public/components?filter[participatory_space_type_eq]=Decidim::Assembly&filter[participatory_space_id_eq]=1982", "title": "Component list for this space", "rel": "resource", "meta": { "space_manifest": "assemblies", "space_id": "1982", "action_method": "GET" } } } } }, "links": { "self": { "href": "https://599.lvh.me/public/assemblies/1982", "title": "en", "rel": "resource", "meta": { "space_id": "1982", "space_manifest": "assemblies", "action_method": "GET" } }, "related": { "href": "https://599.lvh.me/system/organizations/1804", "title": "Deckow-Bradtke", "rel": "resource", "meta": { "action_method": "GET" } } } } ] } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } } } } }, "/spaces/participatory_processes": { "get": { "summary": "List Participatory Processes", "tags": [ "Spaces" ], "operationId": "listParticipatoryProcesses", "description": "List participatory spaces of type Participatory Processes for the current organization. Supports the same `filter` query parameters as `/spaces/search`, scoped to this space type. Extended data filter: `filter[extended_data_cont]` (requires `public.space.extended_data.read`).", "parameters": [ { "name": "locales[]", "in": "query", "style": "form", "explode": true, "schema": { "type": "array", "title": "Available locales", "description": "List of locale codes the organization exposes.", "items": { "$ref": "#/components/schemas/locale" } }, "required": false }, { "name": "page", "in": "query", "description": "Page number for pagination", "required": false, "schema": { "type": "integer" } }, { "name": "per_page", "in": "query", "description": "Number of items per page", "required": false, "schema": { "type": "integer" } }, { "name": "filter[extended_data_cont]", "in": "query", "schema": { "type": "string" }, "required": false, "description": "Search on space extended_data. See [Extended data](https://octree-gva.github.io/decidim-rest-full/integrator/extended-data)." }, { "name": "Authorization", "in": "header", "schema": { "type": "string" }, "required": false, "description": "Bearer access token (see security schemes)" } ], "security": [ { "resourceOwnerFlowBearer": [ "public" ] } ], "responses": { "403": { "description": "Forbidden when filtering extended_data without permission", "content": { "application/json": { "examples": { "filter_extended_data_forbidden": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } }, "forbidden_impersonationFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } }, "forbidden_credentialFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } } }, "schema": { "$ref": "#/components/schemas/error_response" } } } }, "200": { "description": "Participatory Processes list", "content": { "application/json": { "examples": { "filter_by_extended_data_miss": { "value": { "data": [] } }, "filter_by_extended_data": { "value": { "data": [ { "id": "2735", "type": "space", "attributes": { "manifest_name": "participatory_processes", "participatory_space_type": "Decidim::ParticipatoryProcess", "title": { "en": "My participatory_process for testing purpose", "fr": "c'est une concertation" }, "subtitle": { "en": " Fugit itaque non. 51440", "fr": " Ullam quia et. 51441" }, "short_description": { "en": "

Ipsa cumque deleniti. 51443

", "fr": "

Qui reprehenderit maxime. 51444

" }, "description": { "en": "

Distinctio aut ut. 51446

", "fr": "

Doloremque eos nihil. 51447

" }, "visibility": "public", "extended_data": { "idx": "1" }, "created_at": "2026-08-05T07:16:03Z", "updated_at": "2026-08-05T07:16:03Z" }, "relationships": { "components": { "data": [], "meta": { "count": 0 }, "links": { "self": { "href": "https://698.lvh.me/api/rest_full/v0.3/public/components?filter[participatory_space_type_eq]=Decidim::ParticipatoryProcess&filter[participatory_space_id_eq]=2735", "title": "Component list for this space", "rel": "resource", "meta": { "space_manifest": "participatory_processes", "space_id": "2735", "action_method": "GET" } } } } }, "links": { "self": { "href": "https://698.lvh.me/public/participatory_processes/2735", "title": "en", "rel": "resource", "meta": { "space_id": "2735", "space_manifest": "participatory_processes", "action_method": "GET" } }, "related": { "href": "https://698.lvh.me/system/organizations/1819", "title": "Maggio, Ortiz and Bednar", "rel": "resource", "meta": { "action_method": "GET" } } } } ] } }, "ok": { "value": { "data": [ { "id": "2732", "type": "space", "attributes": { "manifest_name": "participatory_processes", "participatory_space_type": "Decidim::ParticipatoryProcess", "title": { "en": " Beatae aperiam quos. 50567", "fr": " Reiciendis adipisci cupiditate. 50568" }, "subtitle": { "en": " Laborum expedita magni. 50570", "fr": " Tenetur error ipsam. 50571" }, "short_description": { "en": "

Quo consequatur magni. 50573

", "fr": "

Est ipsa earum. 50574

" }, "description": { "en": "

Repellat saepe reprehenderit. 50576

", "fr": "

Quisquam quas consequatur. 50577

" }, "visibility": "public", "created_at": "2026-08-05T07:16:00Z", "updated_at": "2026-08-05T07:16:00Z" }, "relationships": { "components": { "data": [], "meta": { "count": 0 }, "links": { "self": { "href": "https://691.lvh.me/api/rest_full/v0.3/public/components?filter[participatory_space_type_eq]=Decidim::ParticipatoryProcess&filter[participatory_space_id_eq]=2732", "title": "Component list for this space", "rel": "resource", "meta": { "space_manifest": "participatory_processes", "space_id": "2732", "action_method": "GET" } } } } }, "links": { "self": { "href": "https://691.lvh.me/public/participatory_processes/2732", "title": "en", "rel": "resource", "meta": { "space_id": "2732", "space_manifest": "participatory_processes", "action_method": "GET" } }, "related": { "href": "https://691.lvh.me/system/organizations/1818", "title": "Wintheiser-Ondricka", "rel": "resource", "meta": { "action_method": "GET" } } } }, { "id": "2734", "type": "space", "attributes": { "manifest_name": "participatory_processes", "participatory_space_type": "Decidim::ParticipatoryProcess", "title": { "en": " Dolorem est earum. 50717", "fr": " Soluta quibusdam iste. 50718" }, "subtitle": { "en": " Sequi dolores nemo. 50720", "fr": " Nemo eveniet facere. 50721" }, "short_description": { "en": "

Reiciendis in quis. 50723

", "fr": "

Quasi dolore non. 50724

" }, "description": { "en": "

Illum maiores vel. 50726

", "fr": "

Unde et repudiandae. 50727

" }, "visibility": "public", "created_at": "2026-08-05T07:16:00Z", "updated_at": "2026-08-05T07:16:00Z" }, "relationships": { "components": { "data": [], "meta": { "count": 0 }, "links": { "self": { "href": "https://691.lvh.me/api/rest_full/v0.3/public/components?filter[participatory_space_type_eq]=Decidim::ParticipatoryProcess&filter[participatory_space_id_eq]=2734", "title": "Component list for this space", "rel": "resource", "meta": { "space_manifest": "participatory_processes", "space_id": "2734", "action_method": "GET" } } } } }, "links": { "self": { "href": "https://691.lvh.me/public/participatory_processes/2734", "title": "en", "rel": "resource", "meta": { "space_id": "2734", "space_manifest": "participatory_processes", "action_method": "GET" } }, "related": { "href": "https://691.lvh.me/system/organizations/1818", "title": "Wintheiser-Ondricka", "rel": "resource", "meta": { "action_method": "GET" } } } }, { "id": "2733", "type": "space", "attributes": { "manifest_name": "participatory_processes", "participatory_space_type": "Decidim::ParticipatoryProcess", "title": { "en": " Nam tempora est. 50642", "fr": " In expedita neque. 50643" }, "subtitle": { "en": " Maiores quis est. 50645", "fr": " Nihil corporis enim. 50646" }, "short_description": { "en": "

Voluptas quis veritatis. 50648

", "fr": "

Reiciendis voluptate aut. 50649

" }, "description": { "en": "

Consequatur non rerum. 50651

", "fr": "

Sint aut laudantium. 50652

" }, "visibility": "public", "created_at": "2026-08-05T07:16:00Z", "updated_at": "2026-08-05T07:16:00Z" }, "relationships": { "components": { "data": [], "meta": { "count": 0 }, "links": { "self": { "href": "https://691.lvh.me/api/rest_full/v0.3/public/components?filter[participatory_space_type_eq]=Decidim::ParticipatoryProcess&filter[participatory_space_id_eq]=2733", "title": "Component list for this space", "rel": "resource", "meta": { "space_manifest": "participatory_processes", "space_id": "2733", "action_method": "GET" } } } } }, "links": { "self": { "href": "https://691.lvh.me/public/participatory_processes/2733", "title": "en", "rel": "resource", "meta": { "space_id": "2733", "space_manifest": "participatory_processes", "action_method": "GET" } }, "related": { "href": "https://691.lvh.me/system/organizations/1818", "title": "Wintheiser-Ondricka", "rel": "resource", "meta": { "action_method": "GET" } } } }, { "id": "2731", "type": "space", "attributes": { "manifest_name": "participatory_processes", "participatory_space_type": "Decidim::ParticipatoryProcess", "title": { "en": "My participatory_process for testing purpose", "fr": "c'est une concertation" }, "subtitle": { "en": " Id quo voluptas. 50495", "fr": " Cumque qui deserunt. 50496" }, "short_description": { "en": "

Cupiditate et labore. 50498

", "fr": "

Quo optio voluptatibus. 50499

" }, "description": { "en": "

Alias dolorum dolores. 50501

", "fr": "

Suscipit libero ipsam. 50502

" }, "visibility": "public", "created_at": "2026-08-05T07:16:00Z", "updated_at": "2026-08-05T07:16:00Z" }, "relationships": { "components": { "data": [], "meta": { "count": 0 }, "links": { "self": { "href": "https://691.lvh.me/api/rest_full/v0.3/public/components?filter[participatory_space_type_eq]=Decidim::ParticipatoryProcess&filter[participatory_space_id_eq]=2731", "title": "Component list for this space", "rel": "resource", "meta": { "space_manifest": "participatory_processes", "space_id": "2731", "action_method": "GET" } } } } }, "links": { "self": { "href": "https://691.lvh.me/public/participatory_processes/2731", "title": "en", "rel": "resource", "meta": { "space_id": "2731", "space_manifest": "participatory_processes", "action_method": "GET" } }, "related": { "href": "https://691.lvh.me/system/organizations/1818", "title": "Wintheiser-Ondricka", "rel": "resource", "meta": { "action_method": "GET" } } } } ] } } }, "schema": { "$ref": "#/components/schemas/space_index_response" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } }, "401": { "description": "Unauthorized when no Bearer token", "content": { "application/json": { "examples": { "unauthorized": { "value": { "error": "401: Unauthorized access", "error_description": "Unauthorized access" } } }, "schema": { "$ref": "#/components/schemas/error_response" } } } } } } }, "/spaces/conferences": { "get": { "summary": "List Conferences", "tags": [ "Spaces" ], "operationId": "listConferences", "description": "List participatory spaces of type Conferences for the current organization. Supports the same `filter` query parameters as `/spaces/search`, scoped to this space type. Extended data filter: `filter[extended_data_cont]` (requires `public.space.extended_data.read`).", "parameters": [ { "name": "locales[]", "in": "query", "style": "form", "explode": true, "schema": { "type": "array", "title": "Available locales", "description": "List of locale codes the organization exposes.", "items": { "$ref": "#/components/schemas/locale" } }, "required": false }, { "name": "page", "in": "query", "description": "Page number for pagination", "required": false, "schema": { "type": "integer" } }, { "name": "per_page", "in": "query", "description": "Number of items per page", "required": false, "schema": { "type": "integer" } }, { "name": "filter[extended_data_cont]", "in": "query", "schema": { "type": "string" }, "required": false, "description": "Search on space extended_data. See [Extended data](https://octree-gva.github.io/decidim-rest-full/integrator/extended-data)." }, { "name": "Authorization", "in": "header", "schema": { "type": "string" }, "required": false, "description": "Bearer access token (see security schemes)" } ], "security": [ { "resourceOwnerFlowBearer": [ "public" ] } ], "responses": { "401": { "description": "Unauthorized when no Bearer token", "content": { "application/json": { "examples": { "unauthorized": { "value": { "error": "401: Unauthorized access", "error_description": "Unauthorized access" } } }, "schema": { "$ref": "#/components/schemas/error_response" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } }, "200": { "description": "Conferences list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/space_index_response" }, "examples": { "ok": { "value": { "data": [ { "id": "67", "type": "space", "attributes": { "manifest_name": "conferences", "participatory_space_type": "Decidim::Conference", "title": { "en": "My conference for testing" }, "subtitle": {}, "short_description": { "en": "

Assumenda molestias optio. 60082

", "fr": "

Soluta corporis a. 60083

" }, "description": { "en": "

Nobis id sapiente. 60085

", "fr": "

Earum tempore quaerat. 60086

" }, "visibility": "public", "created_at": "2026-08-05T07:16:45Z", "updated_at": "2026-08-05T07:16:45Z" }, "relationships": { "components": { "data": [], "meta": { "count": 0 }, "links": { "self": { "href": "https://762.lvh.me/api/rest_full/v0.3/public/components?filter[participatory_space_type_eq]=Decidim::Conference&filter[participatory_space_id_eq]=67", "title": "Component list for this space", "rel": "resource", "meta": { "space_manifest": "conferences", "space_id": "67", "action_method": "GET" } } } } }, "links": { "self": { "href": "https://762.lvh.me/public/conferences/67", "title": "en", "rel": "resource", "meta": { "space_id": "67", "space_manifest": "conferences", "action_method": "GET" } }, "related": { "href": "https://762.lvh.me/system/organizations/1829", "title": "Auer, Wyman and Stamm", "rel": "resource", "meta": { "action_method": "GET" } } } } ] } } } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "examples": { "forbidden_impersonationFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } }, "forbidden_credentialFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } } }, "schema": { "$ref": "#/components/schemas/error_response" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } } } } }, "/spaces/initiatives": { "get": { "summary": "List Initiatives", "tags": [ "Spaces" ], "operationId": "listInitiatives", "description": "List participatory spaces of type Initiatives for the current organization. Supports the same `filter` query parameters as `/spaces/search`, scoped to this space type. Extended data filter: `filter[extended_data_cont]` (requires `public.space.extended_data.read`).", "parameters": [ { "name": "locales[]", "in": "query", "style": "form", "explode": true, "schema": { "type": "array", "title": "Available locales", "description": "List of locale codes the organization exposes.", "items": { "$ref": "#/components/schemas/locale" } }, "required": false }, { "name": "page", "in": "query", "description": "Page number for pagination", "required": false, "schema": { "type": "integer" } }, { "name": "per_page", "in": "query", "description": "Number of items per page", "required": false, "schema": { "type": "integer" } }, { "name": "filter[extended_data_cont]", "in": "query", "schema": { "type": "string" }, "required": false, "description": "Search on space extended_data. See [Extended data](https://octree-gva.github.io/decidim-rest-full/integrator/extended-data)." }, { "name": "Authorization", "in": "header", "schema": { "type": "string" }, "required": false, "description": "Bearer access token (see security schemes)" } ], "security": [ { "resourceOwnerFlowBearer": [ "public" ] } ], "responses": { "403": { "description": "Forbidden", "content": { "application/json": { "examples": { "forbidden_credentialFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } }, "forbidden_impersonationFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } } }, "schema": { "$ref": "#/components/schemas/error_response" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } }, "200": { "description": "Initiatives list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/space_index_response" }, "examples": { "ok": { "value": { "data": [ { "id": "60", "type": "space", "attributes": { "manifest_name": "initiatives", "participatory_space_type": "Decidim::Initiative", "title": { "en": "My initiative for testing" }, "subtitle": {}, "short_description": {}, "description": { "en": "

Non sapiente nihil. 70649

", "fr": "

Quia vel nemo. 70650

" }, "visibility": "public", "created_at": "2026-08-05T07:17:48Z", "updated_at": "2026-08-05T07:17:48Z" }, "relationships": { "components": { "data": [], "meta": { "count": 0 }, "links": { "self": { "href": "https://839.lvh.me/api/rest_full/v0.3/public/components?filter[participatory_space_type_eq]=Decidim::Initiative&filter[participatory_space_id_eq]=60", "title": "Component list for this space", "rel": "resource", "meta": { "space_manifest": "initiatives", "space_id": "60", "action_method": "GET" } } } } }, "links": { "self": { "href": "https://839.lvh.me/public/initiatives/60", "title": "en", "rel": "resource", "meta": { "space_id": "60", "space_manifest": "initiatives", "action_method": "GET" } }, "related": { "href": "https://839.lvh.me/system/organizations/1840", "title": "Schultz Inc", "rel": "resource", "meta": { "action_method": "GET" } } } } ] } } } } } }, "401": { "description": "Unauthorized when no Bearer token", "content": { "application/json": { "examples": { "unauthorized": { "value": { "error": "401: Unauthorized access", "error_description": "Unauthorized access" } } }, "schema": { "$ref": "#/components/schemas/error_response" } } } } } } }, "/components/search": { "get": { "summary": "Search components", "tags": [ "Components" ], "operationId": "searchComponents", "description": "Search **components** (`Decidim::Component`) in the organization resolved from the request host.\n\n### Filters\n- `filter[manifest_name]`: e.g. `proposals`, `blogs`, `meetings`\n- `filter[id]`, `filter[participatory_space_id]`, `filter[participatory_space_type]`, `filter[name]`\n\n### Pagination & locale\nSupports `page`, `per_page`, and `locales[]` like other collection endpoints.\n\n### Access\n`public` scope with `public.component.read` (credential or impersonation token).\n", "parameters": [ { "name": "page", "in": "query", "description": "Page number for pagination", "required": false, "schema": { "type": "integer" } }, { "name": "per_page", "in": "query", "description": "Number of items per page", "required": false, "schema": { "type": "integer" } }, { "name": "locales[]", "in": "query", "style": "form", "explode": true, "schema": { "type": "array", "title": "Available locales", "description": "List of locale codes the organization exposes.", "items": { "$ref": "#/components/schemas/locale" } }, "required": false }, { "name": "filter[manifest_name_not_in][]", "in": "query", "style": "form", "explode": true, "schema": { "type": "array", "items": { "$ref": "#/components/schemas/component_manifest" }, "title": "manifest_name not IN filter", "description": "match none of _manifest_name_'s values in array" }, "required": false }, { "name": "filter[manifest_name_in][]", "in": "query", "style": "form", "explode": true, "schema": { "type": "array", "items": { "$ref": "#/components/schemas/component_manifest" }, "title": "manifest_name IN filter", "description": "match one of _manifest_name_'s values in array" }, "required": false }, { "name": "filter[manifest_name_start]", "in": "query", "schema": { "type": "string", "description": "_manifest_name_ starts with", "title": "manifest_name starts With filter", "example": "some_string" }, "required": false }, { "name": "filter[manifest_name_eq]", "in": "query", "schema": { "$ref": "#/components/schemas/component_manifest", "title": "manifest_name equal filter", "description": "_manifest_name_ is equal to" }, "required": false }, { "name": "filter[manifest_name_not_eq]", "in": "query", "schema": { "$ref": "#/components/schemas/component_manifest", "title": "manifest_name not equal filter", "description": "_manifest_name_ is NOT equal to" }, "required": false }, { "name": "filter[manifest_name_matches]", "in": "query", "schema": { "type": "string", "title": "manifest_name like filter", "description": "matches _manifest_name_ with `LIKE`", "example": "%some_string" }, "required": false }, { "name": "filter[manifest_name_blank]", "in": "query", "schema": { "type": "boolean", "title": "manifest_name blank filter", "description": "_manifest_name_ is null or empty" }, "required": false }, { "name": "filter[id_in][]", "in": "query", "style": "form", "explode": true, "schema": { "type": "array", "items": { "type": "integer" }, "title": "id IN filter", "description": "match one of _id_'s values in array" }, "required": false }, { "name": "filter[id_eq]", "in": "query", "schema": { "type": "integer", "title": "id equal filter", "description": "_id_ is equal to" }, "required": false }, { "name": "filter[id_lt]", "in": "query", "schema": { "type": "integer", "title": "id less than filter", "description": "_id_ is less than" }, "required": false }, { "name": "filter[id_gt]", "in": "query", "schema": { "type": "integer", "title": "id greater than filter", "description": "_id_ is greater than" }, "required": false }, { "name": "filter[id_present]", "in": "query", "schema": { "type": "boolean", "title": "id present filter", "description": "_id_ is not null and not empty" }, "required": false }, { "name": "filter[id_blank]", "in": "query", "schema": { "type": "boolean", "title": "id blank filter", "description": "_id_ is null or empty" }, "required": false }, { "name": "filter[participatory_space_id_in][]", "in": "query", "style": "form", "explode": true, "schema": { "type": "array", "items": { "type": "string" }, "title": "participatory_space_id IN filter", "description": "match one of _participatory_space_id_'s values in array" }, "required": false }, { "name": "filter[participatory_space_id_eq]", "in": "query", "schema": { "type": "string", "title": "participatory_space_id equal filter", "description": "_participatory_space_id_ is equal to" }, "required": false }, { "name": "filter[participatory_space_id_lt]", "in": "query", "schema": { "type": "string", "title": "participatory_space_id less than filter", "description": "_participatory_space_id_ is less than" }, "required": false }, { "name": "filter[participatory_space_id_gt]", "in": "query", "schema": { "type": "string", "title": "participatory_space_id greater than filter", "description": "_participatory_space_id_ is greater than" }, "required": false }, { "name": "filter[participatory_space_id_present]", "in": "query", "schema": { "type": "boolean", "title": "participatory_space_id present filter", "description": "_participatory_space_id_ is not null and not empty" }, "required": false }, { "name": "filter[participatory_space_id_blank]", "in": "query", "schema": { "type": "boolean", "title": "participatory_space_id blank filter", "description": "_participatory_space_id_ is null or empty" }, "required": false }, { "name": "filter[participatory_space_type_not_in][]", "in": "query", "style": "form", "explode": true, "schema": { "type": "array", "items": { "$ref": "#/components/schemas/space_type" }, "title": "participatory_space_type not IN filter", "description": "match none of _participatory_space_type_'s values in array" }, "required": false }, { "name": "filter[participatory_space_type_in][]", "in": "query", "style": "form", "explode": true, "schema": { "type": "array", "items": { "$ref": "#/components/schemas/space_type" }, "title": "participatory_space_type IN filter", "description": "match one of _participatory_space_type_'s values in array" }, "required": false }, { "name": "filter[participatory_space_type_start]", "in": "query", "schema": { "type": "string", "description": "_participatory_space_type_ starts with", "title": "participatory_space_type starts With filter", "example": "some_string" }, "required": false }, { "name": "filter[participatory_space_type_eq]", "in": "query", "schema": { "$ref": "#/components/schemas/space_type", "title": "participatory_space_type equal filter", "description": "_participatory_space_type_ is equal to" }, "required": false }, { "name": "filter[participatory_space_type_not_eq]", "in": "query", "schema": { "$ref": "#/components/schemas/space_type", "title": "participatory_space_type not equal filter", "description": "_participatory_space_type_ is NOT equal to" }, "required": false }, { "name": "filter[participatory_space_type_matches]", "in": "query", "schema": { "type": "string", "title": "participatory_space_type like filter", "description": "matches _participatory_space_type_ with `LIKE`", "example": "%some_string" }, "required": false }, { "name": "filter[participatory_space_type_blank]", "in": "query", "schema": { "type": "boolean", "title": "participatory_space_type blank filter", "description": "_participatory_space_type_ is null or empty" }, "required": false }, { "name": "filter[name_not_in][]", "in": "query", "style": "form", "explode": true, "schema": { "type": "array", "items": { "type": "string" }, "title": "name not IN filter", "description": "match none of _name_'s values in array" }, "required": false }, { "name": "filter[name_in][]", "in": "query", "style": "form", "explode": true, "schema": { "type": "array", "items": { "type": "string" }, "title": "name IN filter", "description": "match one of _name_'s values in array" }, "required": false }, { "name": "filter[name_start]", "in": "query", "schema": { "type": "string", "description": "_name_ starts with", "title": "name starts With filter", "example": "some_string" }, "required": false }, { "name": "filter[name_eq]", "in": "query", "schema": { "type": "string", "title": "name equal filter", "description": "_name_ is equal to" }, "required": false }, { "name": "filter[name_not_eq]", "in": "query", "schema": { "type": "string", "title": "name not equal filter", "description": "_name_ is NOT equal to" }, "required": false }, { "name": "filter[name_matches]", "in": "query", "schema": { "type": "string", "title": "name like filter", "description": "matches _name_ with `LIKE`", "example": "%some_string" }, "required": false }, { "name": "filter[name_blank]", "in": "query", "schema": { "type": "boolean", "title": "name blank filter", "description": "_name_ is null or empty" }, "required": false }, { "name": "filter[extended_data_cont]", "in": "query", "schema": { "type": "string" }, "required": false, "description": "Search on component extended_data. Format: `\"\":\"\"`. Requires `public.component.extended_data.read`. See [Extended data](https://octree-gva.github.io/decidim-rest-full/integrator/extended-data)." }, { "name": "Authorization", "in": "header", "schema": { "type": "string" }, "required": false, "description": "Bearer access token (see security schemes)" } ], "security": [ { "credentialFlowBearer": [ "public" ] } ], "responses": { "403": { "description": "Forbidden", "content": { "application/json": { "examples": { "filter_extended_data_forbidden": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } }, "forbidden_impersonationFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } }, "forbidden_credentialFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } } }, "schema": { "$ref": "#/components/schemas/error_response" } } } }, "200": { "description": "List of components", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/component_index_response" }, "examples": { "paginated": { "value": { "data": [ { "id": "9022", "type": "survey_component", "attributes": { "manifest_name": "surveys", "participatory_space_type": "Decidim::Assembly", "participatory_space_id": "2150", "name": { "en": " Minima enim qui. 80701", "fr": " Dolor aliquid voluptas. 80702" }, "global_announcement": {}, "created_at": "2026-08-05T07:18:55Z", "updated_at": "2026-08-05T07:18:55Z" }, "relationships": { "resources": { "data": [], "meta": { "count": 0 } } }, "links": { "self": { "href": "https://930.lvh.me/components/survey_components/9022", "title": " Minima enim qui. 80701", "rel": "resource", "meta": { "space_id": "2150", "space_manifest": "assemblies", "action_method": "GET" } }, "related": { "href": "https://930.lvh.me/spaces/assemblies/2150", "title": " Maxime id voluptas. 80429", "rel": "resource", "meta": { "space_id": "2150", "space_manifest": "assemblies", "action_method": "GET" } } }, "meta": { "published": true, "scopes_enabled": false } }, { "id": "9023", "type": "meeting_component", "attributes": { "manifest_name": "meetings", "participatory_space_type": "Decidim::Assembly", "participatory_space_id": "2150", "name": { "en": " Qui quis placeat. 80710", "fr": " Voluptatem animi placeat. 80711" }, "global_announcement": {}, "created_at": "2026-08-05T07:18:55Z", "updated_at": "2026-08-05T07:18:55Z" }, "relationships": { "resources": { "data": [], "meta": { "count": 0 } } }, "links": { "self": { "href": "https://930.lvh.me/components/meeting_components/9023", "title": " Qui quis placeat. 80710", "rel": "resource", "meta": { "space_id": "2150", "space_manifest": "assemblies", "action_method": "GET" } }, "related": { "href": "https://930.lvh.me/spaces/assemblies/2150", "title": " Maxime id voluptas. 80429", "rel": "resource", "meta": { "space_id": "2150", "space_manifest": "assemblies", "action_method": "GET" } } }, "meta": { "published": true, "scopes_enabled": false, "default_registration_terms": {}, "comments_enabled": true, "comments_max_length": 1000, "registration_code_enabled": true, "creation_enabled_for_participants": false } } ] } }, "filter_by_extended_data_miss": { "value": { "data": [] } }, "manifest_name_in_Meetings": { "value": { "data": [ { "id": "8976", "type": "meeting_component", "attributes": { "manifest_name": "meetings", "participatory_space_type": "Decidim::ParticipatoryProcess", "participatory_space_id": "2845", "name": { "en": " Suscipit minus ducimus. 78892", "fr": " Molestias illum dolorum. 78893" }, "global_announcement": {}, "created_at": "2026-08-05T07:18:43Z", "updated_at": "2026-08-05T07:18:43Z" }, "relationships": { "resources": { "data": [], "meta": { "count": 0 } } }, "links": { "self": { "href": "https://915.lvh.me/components/meeting_components/8976", "title": " Suscipit minus ducimus. 78892", "rel": "resource", "meta": { "space_id": "2845", "space_manifest": "participatory_processes", "action_method": "GET" } }, "related": { "href": "https://915.lvh.me/spaces/participatory_processes/2845", "title": " Corrupti saepe molestiae. 78856", "rel": "resource", "meta": { "space_id": "2845", "space_manifest": "participatory_processes", "action_method": "GET" } } }, "meta": { "published": true, "scopes_enabled": false, "default_registration_terms": {}, "comments_enabled": true, "comments_max_length": 1000, "registration_code_enabled": true, "creation_enabled_for_participants": false } } ] } }, "filter_byId": { "value": { "data": [ { "id": "8980", "type": "meeting_component", "attributes": { "manifest_name": "meetings", "participatory_space_type": "Decidim::ParticipatoryProcess", "participatory_space_id": "2846", "name": { "en": " Eum minima ex. 79176", "fr": " Deleniti incidunt ex. 79177" }, "global_announcement": {}, "created_at": "2026-08-05T07:18:44Z", "updated_at": "2026-08-05T07:18:44Z" }, "relationships": { "resources": { "data": [], "meta": { "count": 0 } } }, "links": { "self": { "href": "https://918.lvh.me/components/meeting_components/8980", "title": " Eum minima ex. 79176", "rel": "resource", "meta": { "space_id": "2846", "space_manifest": "participatory_processes", "action_method": "GET" } }, "related": { "href": "https://918.lvh.me/spaces/participatory_processes/2846", "title": " Earum nihil tenetur. 79140", "rel": "resource", "meta": { "space_id": "2846", "space_manifest": "participatory_processes", "action_method": "GET" } } }, "meta": { "published": true, "scopes_enabled": false, "default_registration_terms": {}, "comments_enabled": true, "comments_max_length": 1000, "registration_code_enabled": true, "creation_enabled_for_participants": false } }, { "id": "8981", "type": "proposal_component", "attributes": { "manifest_name": "proposals", "participatory_space_type": "Decidim::ParticipatoryProcess", "participatory_space_id": "2846", "name": { "en": " Sunt et perferendis. 79311", "fr": " Voluptas quaerat aliquid. 79312" }, "global_announcement": {}, "created_at": "2026-08-05T07:18:44Z", "updated_at": "2026-08-05T07:18:45Z" }, "relationships": { "resources": { "data": [ { "id": "4708", "type": "proposal" }, { "id": "4707", "type": "proposal" } ], "meta": { "count": 2 } } }, "links": { "self": { "href": "https://918.lvh.me/components/proposal_components/8981", "title": " Sunt et perferendis. 79311", "rel": "resource", "meta": { "space_id": "2846", "space_manifest": "participatory_processes", "action_method": "GET" } }, "related": { "href": "https://918.lvh.me/spaces/participatory_processes/2846", "title": " Earum nihil tenetur. 79140", "rel": "resource", "meta": { "space_id": "2846", "space_manifest": "participatory_processes", "action_method": "GET" } } }, "meta": { "published": true, "scopes_enabled": false, "amendments_enabled": false, "attachments_allowed": false, "comments_enabled": true, "comments_max_length": 1000, "default_sort_order": "default", "geocoding_enabled": false, "minimum_votes_per_user": 0, "official_proposals_enabled": true, "participatory_texts_enabled": false, "proposal_edit_time": "limited", "proposal_limit": 0, "resources_permissions_enabled": true, "threshold_per_proposal": 0, "vote_limit": 0, "collaborative_drafts_enabled": false, "proposal_edit_before_minutes": 5, "votes_enabled": false, "creation_enabled": false, "proposal_answering_enabled": true, "amendment_creation_enabled": true, "amendment_reaction_enabled": true, "amendment_promotion_enabled": true, "endorsements_enabled": true, "can_create_proposals": false, "can_vote": false, "can_endorse": true, "can_comment": true } } ] } }, "components_in_Process": { "value": { "data": [ { "id": "8964", "type": "meeting_component", "attributes": { "manifest_name": "meetings", "participatory_space_type": "Decidim::ParticipatoryProcess", "participatory_space_id": "2842", "name": { "en": " Quis corporis esse. 78040", "fr": " Quam qui laudantium. 78041" }, "global_announcement": {}, "created_at": "2026-08-05T07:18:35Z", "updated_at": "2026-08-05T07:18:35Z" }, "relationships": { "resources": { "data": [], "meta": { "count": 0 } } }, "links": { "self": { "href": "https://906.lvh.me/components/meeting_components/8964", "title": " Quis corporis esse. 78040", "rel": "resource", "meta": { "space_id": "2842", "space_manifest": "participatory_processes", "action_method": "GET" } }, "related": { "href": "https://906.lvh.me/spaces/participatory_processes/2842", "title": " Soluta nihil omnis. 78004", "rel": "resource", "meta": { "space_id": "2842", "space_manifest": "participatory_processes", "action_method": "GET" } } }, "meta": { "published": true, "scopes_enabled": false, "default_registration_terms": {}, "comments_enabled": true, "comments_max_length": 1000, "registration_code_enabled": true, "creation_enabled_for_participants": false } }, { "id": "8965", "type": "proposal_component", "attributes": { "manifest_name": "proposals", "participatory_space_type": "Decidim::ParticipatoryProcess", "participatory_space_id": "2842", "name": { "en": " Omnis sint harum. 78175", "fr": " Aut et nobis. 78176" }, "global_announcement": {}, "created_at": "2026-08-05T07:18:35Z", "updated_at": "2026-08-05T07:18:36Z" }, "relationships": { "resources": { "data": [ { "id": "4699", "type": "proposal" }, { "id": "4700", "type": "proposal" } ], "meta": { "count": 2 } } }, "links": { "self": { "href": "https://906.lvh.me/components/proposal_components/8965", "title": " Omnis sint harum. 78175", "rel": "resource", "meta": { "space_id": "2842", "space_manifest": "participatory_processes", "action_method": "GET" } }, "related": { "href": "https://906.lvh.me/spaces/participatory_processes/2842", "title": " Soluta nihil omnis. 78004", "rel": "resource", "meta": { "space_id": "2842", "space_manifest": "participatory_processes", "action_method": "GET" } } }, "meta": { "published": true, "scopes_enabled": false, "amendments_enabled": false, "attachments_allowed": false, "comments_enabled": true, "comments_max_length": 1000, "default_sort_order": "default", "geocoding_enabled": false, "minimum_votes_per_user": 0, "official_proposals_enabled": true, "participatory_texts_enabled": false, "proposal_edit_time": "limited", "proposal_limit": 0, "resources_permissions_enabled": true, "threshold_per_proposal": 0, "vote_limit": 0, "collaborative_drafts_enabled": false, "proposal_edit_before_minutes": 5, "votes_enabled": false, "creation_enabled": false, "proposal_answering_enabled": true, "amendment_creation_enabled": true, "amendment_reaction_enabled": true, "amendment_promotion_enabled": true, "endorsements_enabled": true, "can_create_proposals": false, "can_vote": false, "can_endorse": true, "can_comment": true } }, { "id": "8966", "type": "proposal_component", "attributes": { "manifest_name": "proposals", "participatory_space_type": "Decidim::ParticipatoryProcess", "participatory_space_id": "2842", "name": { "en": " Proposals" }, "global_announcement": {}, "created_at": "2026-08-05T07:18:36Z", "updated_at": "2026-08-05T07:18:36Z" }, "relationships": { "resources": { "data": [], "meta": { "count": 0 } } }, "links": { "self": { "href": "https://906.lvh.me/components/proposal_components/8966", "title": " Proposals", "rel": "resource", "meta": { "space_id": "2842", "space_manifest": "participatory_processes", "action_method": "GET" } }, "related": { "href": "https://906.lvh.me/spaces/participatory_processes/2842", "title": " Soluta nihil omnis. 78004", "rel": "resource", "meta": { "space_id": "2842", "space_manifest": "participatory_processes", "action_method": "GET" } } }, "meta": { "published": true, "scopes_enabled": false, "amendments_enabled": false, "attachments_allowed": false, "comments_enabled": true, "comments_max_length": 0, "default_sort_order": "default", "geocoding_enabled": false, "minimum_votes_per_user": 0, "official_proposals_enabled": true, "participatory_texts_enabled": false, "proposal_edit_time": "limited", "proposal_limit": 0, "resources_permissions_enabled": true, "threshold_per_proposal": 0, "vote_limit": 0, "collaborative_drafts_enabled": false, "proposal_edit_before_minutes": 5, "votes_enabled": true, "creation_enabled": false, "proposal_answering_enabled": true, "amendment_creation_enabled": true, "amendment_reaction_enabled": true, "amendment_promotion_enabled": true, "endorsements_enabled": true, "can_create_proposals": false, "can_vote": true, "can_endorse": true, "can_comment": true, "votes": [ { "weight": 1, "label": { "en": "Red", "fr": "Rouge" } }, { "weight": 2, "label": { "en": "Yellow", "fr": "Jaune" } }, { "weight": 3, "label": { "en": "Green", "fr": "Verte" } } ] } }, { "id": "8967", "type": "accountability_component", "attributes": { "manifest_name": "accountability", "participatory_space_type": "Decidim::ParticipatoryProcess", "participatory_space_id": "2842", "name": { "en": " Accountability" }, "global_announcement": {}, "created_at": "2026-08-05T07:18:36Z", "updated_at": "2026-08-05T07:18:36Z" }, "relationships": { "resources": { "data": [ { "id": "259", "type": "result" }, { "id": "260", "type": "result" } ], "meta": { "count": 2 } } }, "links": { "self": { "href": "https://906.lvh.me/components/accountability_components/8967", "title": " Accountability", "rel": "resource", "meta": { "space_id": "2842", "space_manifest": "participatory_processes", "action_method": "GET" } }, "related": { "href": "https://906.lvh.me/spaces/participatory_processes/2842", "title": " Soluta nihil omnis. 78004", "rel": "resource", "meta": { "space_id": "2842", "space_manifest": "participatory_processes", "action_method": "GET" } } }, "meta": { "published": true, "scopes_enabled": false } } ] } }, "ok": { "value": { "data": [ { "id": "8968", "type": "meeting_component", "attributes": { "manifest_name": "meetings", "participatory_space_type": "Decidim::ParticipatoryProcess", "participatory_space_id": "2843", "name": { "en": " Soluta aut explicabo. 78324", "fr": " Hic reprehenderit veniam. 78325" }, "global_announcement": {}, "created_at": "2026-08-05T07:18:38Z", "updated_at": "2026-08-05T07:18:38Z" }, "relationships": { "resources": { "data": [], "meta": { "count": 0 } } }, "links": { "self": { "href": "https://909.lvh.me/components/meeting_components/8968", "title": " Soluta aut explicabo. 78324", "rel": "resource", "meta": { "space_id": "2843", "space_manifest": "participatory_processes", "action_method": "GET" } }, "related": { "href": "https://909.lvh.me/spaces/participatory_processes/2843", "title": " Iure aut labore. 78288", "rel": "resource", "meta": { "space_id": "2843", "space_manifest": "participatory_processes", "action_method": "GET" } } }, "meta": { "published": true, "scopes_enabled": false, "default_registration_terms": {}, "comments_enabled": true, "comments_max_length": 1000, "registration_code_enabled": true, "creation_enabled_for_participants": false } }, { "id": "8969", "type": "proposal_component", "attributes": { "manifest_name": "proposals", "participatory_space_type": "Decidim::ParticipatoryProcess", "participatory_space_id": "2843", "name": { "en": " Laudantium deleniti id. 78459", "fr": " Dicta et veniam. 78460" }, "global_announcement": {}, "created_at": "2026-08-05T07:18:38Z", "updated_at": "2026-08-05T07:18:39Z" }, "relationships": { "resources": { "data": [ { "id": "4701", "type": "proposal" }, { "id": "4702", "type": "proposal" } ], "meta": { "count": 2 } } }, "links": { "self": { "href": "https://909.lvh.me/components/proposal_components/8969", "title": " Laudantium deleniti id. 78459", "rel": "resource", "meta": { "space_id": "2843", "space_manifest": "participatory_processes", "action_method": "GET" } }, "related": { "href": "https://909.lvh.me/spaces/participatory_processes/2843", "title": " Iure aut labore. 78288", "rel": "resource", "meta": { "space_id": "2843", "space_manifest": "participatory_processes", "action_method": "GET" } } }, "meta": { "published": true, "scopes_enabled": false, "amendments_enabled": false, "attachments_allowed": false, "comments_enabled": true, "comments_max_length": 1000, "default_sort_order": "default", "geocoding_enabled": false, "minimum_votes_per_user": 0, "official_proposals_enabled": true, "participatory_texts_enabled": false, "proposal_edit_time": "limited", "proposal_limit": 0, "resources_permissions_enabled": true, "threshold_per_proposal": 0, "vote_limit": 0, "collaborative_drafts_enabled": false, "proposal_edit_before_minutes": 5, "votes_enabled": false, "creation_enabled": false, "proposal_answering_enabled": true, "amendment_creation_enabled": true, "amendment_reaction_enabled": true, "amendment_promotion_enabled": true, "endorsements_enabled": true, "can_create_proposals": false, "can_vote": false, "can_endorse": true, "can_comment": true } }, { "id": "8970", "type": "proposal_component", "attributes": { "manifest_name": "proposals", "participatory_space_type": "Decidim::ParticipatoryProcess", "participatory_space_id": "2843", "name": { "en": " Proposals" }, "global_announcement": {}, "created_at": "2026-08-05T07:18:39Z", "updated_at": "2026-08-05T07:18:39Z" }, "relationships": { "resources": { "data": [], "meta": { "count": 0 } } }, "links": { "self": { "href": "https://909.lvh.me/components/proposal_components/8970", "title": " Proposals", "rel": "resource", "meta": { "space_id": "2843", "space_manifest": "participatory_processes", "action_method": "GET" } }, "related": { "href": "https://909.lvh.me/spaces/participatory_processes/2843", "title": " Iure aut labore. 78288", "rel": "resource", "meta": { "space_id": "2843", "space_manifest": "participatory_processes", "action_method": "GET" } } }, "meta": { "published": true, "scopes_enabled": false, "amendments_enabled": false, "attachments_allowed": false, "comments_enabled": true, "comments_max_length": 0, "default_sort_order": "default", "geocoding_enabled": false, "minimum_votes_per_user": 0, "official_proposals_enabled": true, "participatory_texts_enabled": false, "proposal_edit_time": "limited", "proposal_limit": 0, "resources_permissions_enabled": true, "threshold_per_proposal": 0, "vote_limit": 0, "collaborative_drafts_enabled": false, "proposal_edit_before_minutes": 5, "votes_enabled": true, "creation_enabled": false, "proposal_answering_enabled": true, "amendment_creation_enabled": true, "amendment_reaction_enabled": true, "amendment_promotion_enabled": true, "endorsements_enabled": true, "can_create_proposals": false, "can_vote": true, "can_endorse": true, "can_comment": true, "votes": [ { "weight": 1, "label": { "en": "Red", "fr": "Rouge" } }, { "weight": 2, "label": { "en": "Yellow", "fr": "Jaune" } }, { "weight": 3, "label": { "en": "Green", "fr": "Verte" } } ] } }, { "id": "8971", "type": "accountability_component", "attributes": { "manifest_name": "accountability", "participatory_space_type": "Decidim::ParticipatoryProcess", "participatory_space_id": "2843", "name": { "en": " Accountability" }, "global_announcement": {}, "created_at": "2026-08-05T07:18:39Z", "updated_at": "2026-08-05T07:18:39Z" }, "relationships": { "resources": { "data": [ { "id": "261", "type": "result" }, { "id": "262", "type": "result" } ], "meta": { "count": 2 } } }, "links": { "self": { "href": "https://909.lvh.me/components/accountability_components/8971", "title": " Accountability", "rel": "resource", "meta": { "space_id": "2843", "space_manifest": "participatory_processes", "action_method": "GET" } }, "related": { "href": "https://909.lvh.me/spaces/participatory_processes/2843", "title": " Iure aut labore. 78288", "rel": "resource", "meta": { "space_id": "2843", "space_manifest": "participatory_processes", "action_method": "GET" } } }, "meta": { "published": true, "scopes_enabled": false } } ] } }, "filter_by_extended_data": { "value": { "data": [ { "id": "8972", "type": "meeting_component", "attributes": { "manifest_name": "meetings", "participatory_space_type": "Decidim::ParticipatoryProcess", "participatory_space_id": "2844", "extended_data": { "sync": "ok" }, "name": { "en": " Et possimus assumenda. 78608" }, "global_announcement": {}, "created_at": "2026-08-05T07:18:40Z", "updated_at": "2026-08-05T07:18:40Z" }, "relationships": { "resources": { "data": [], "meta": { "count": 0 } } }, "links": { "self": { "href": "https://912.lvh.me/components/meeting_components/8972", "title": " Et possimus assumenda. 78608", "rel": "resource", "meta": { "space_id": "2844", "space_manifest": "participatory_processes", "action_method": "GET" } }, "related": { "href": "https://912.lvh.me/spaces/participatory_processes/2844", "title": " Ipsum eius quia. 78572", "rel": "resource", "meta": { "space_id": "2844", "space_manifest": "participatory_processes", "action_method": "GET" } } }, "meta": { "published": true, "scopes_enabled": false, "default_registration_terms": {}, "comments_enabled": true, "comments_max_length": 1000, "registration_code_enabled": true, "creation_enabled_for_participants": false } } ] } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } } } } }, "/blogs": { "post": { "summary": "Create blog post (async)", "tags": [ "Blogs" ], "operationId": "createBlogPostAsync", "description": "Enqueue creation of a blog post. Poll `GET /jobs/:uuid`.\n\nSet `published_at` to control visibility (see **Blogs** tag). Requires `blogs.write` and impersonation.\n", "parameters": [ { "name": "Authorization", "in": "header", "schema": { "type": "string" }, "required": false, "description": "Bearer access token (see security schemes)" } ], "security": [ { "resourceOwnerFlowBearer": [ "blogs" ] } ], "responses": { "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" }, "examples": { "forbidden_impersonationFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } }, "202": { "description": "Job accepted", "content": { "application/json": { "examples": { "accepted": { "value": { "job_id": "49cc7d17-d07c-45af-9e22-0f6384762edd", "status": "pending", "data": null, "return_value": null, "poll_url": "https://957.lvh.me/api/rest_full/v0.3/jobs/49cc7d17-d07c-45af-9e22-0f6384762edd", "links": { "self": { "href": "https://957.lvh.me/api/rest_full/v0.3/jobs/49cc7d17-d07c-45af-9e22-0f6384762edd", "title": "API job status", "rel": "resource", "meta": { "action_method": "GET" } } } } } }, "schema": { "$ref": "#/components/schemas/rest_full_api_job_accepted" } } } } }, "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/blog_post_create_payload" } } }, "required": true } }, "get": { "summary": "List posts", "tags": [ "Blogs" ], "operationId": "listBlogPosts", "description": "List posts (Decidim::Blogs::Post)", "parameters": [ { "name": "locales[]", "in": "query", "style": "form", "explode": true, "schema": { "type": "array", "title": "Available locales", "description": "List of locale codes the organization exposes.", "items": { "$ref": "#/components/schemas/locale" } }, "required": false }, { "name": "page", "in": "query", "description": "Page number for pagination", "required": false, "schema": { "type": "integer" } }, { "name": "per_page", "in": "query", "description": "Number of items per page", "required": false, "schema": { "type": "integer" } }, { "name": "space_manifest", "in": "query", "schema": { "type": "string", "enum": [ "participatory_processes", "assemblies", "conferences", "initiatives" ], "description": "Space type" }, "required": false }, { "name": "space_id", "in": "query", "schema": { "type": "integer", "description": "Space Id" }, "required": false }, { "name": "component_id", "in": "query", "schema": { "type": "integer", "description": "Component Id" }, "required": false }, { "name": "order", "in": "query", "schema": { "type": "string" }, "description": "Order by", "required": false }, { "name": "order_direction", "in": "query", "schema": { "type": "string", "enum": [ "asc", "desc" ] }, "description": "Order direction", "required": false }, { "name": "Authorization", "in": "header", "schema": { "type": "string" }, "required": false, "description": "Bearer access token (see security schemes)" } ], "security": [ { "credentialFlowBearer": [ "blogs" ] } ], "responses": { "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } }, "200": { "description": "Blogs Found", "content": { "application/json": { "examples": { "ok_empty": { "value": { "data": [] } }, "paginated": { "value": { "data": [ { "id": "377", "type": "blog", "attributes": { "created_at": "2026-08-05T07:21:13Z", "updated_at": "2026-08-05T07:21:13Z", "title": { "en": " Et dolore enim. 85232", "fr": " Consequatur tempore aliquam. 85233" }, "body": { "en": "

Quia aspernatur aut. 85235

", "fr": "

Harum laborum sint. 85236

" }, "published_at": "2026-08-05T07:20:13.428Z" }, "relationships": { "space": { "data": { "id": "2888", "type": "participatory_processes" } }, "component": { "data": { "id": "9088", "type": "blog_component" } } }, "links": { "related": { "href": "https://1008.lvh.me/public/components/9088", "title": " Autem et blanditiis. 85196", "rel": "resource", "meta": { "space_id": "2888", "space_manifest": "participatory_processes", "component_id": "9088", "component_manifest": "blogs", "action_method": "GET" } }, "self": { "href": "https://1008.lvh.me/api/rest_full/v0.3/blogs/377", "title": "Blogs Details", "rel": "resource", "meta": { "component_id": "9088", "component_manifest": "blogs", "space_id": "2888", "space_manifest": "participatory_processes", "resource_id": "377", "action_method": "GET" } }, "collection": { "href": "https://1008.lvh.me/api/rest_full/v0.3/blogs", "title": "Blogs List", "rel": "resource", "meta": { "component_id": "9088", "component_manifest": "blogs", "space_id": "2888", "space_manifest": "participatory_processes", "resource_id": "377", "action_method": "GET" } } }, "meta": { "published": true } }, { "id": "379", "type": "blog", "attributes": { "created_at": "2026-08-05T07:21:13Z", "updated_at": "2026-08-05T07:21:13Z", "title": { "en": " Esse qui quia. 85246", "fr": " Molestiae molestias ut. 85247" }, "body": { "en": "

Non labore culpa. 85249

", "fr": "

Et quia et. 85250

" }, "published_at": "2026-08-05T07:18:13.472Z" }, "relationships": { "space": { "data": { "id": "2888", "type": "participatory_processes" } }, "component": { "data": { "id": "9088", "type": "blog_component" } } }, "links": { "related": { "href": "https://1008.lvh.me/public/components/9088", "title": " Autem et blanditiis. 85196", "rel": "resource", "meta": { "space_id": "2888", "space_manifest": "participatory_processes", "component_id": "9088", "component_manifest": "blogs", "action_method": "GET" } }, "self": { "href": "https://1008.lvh.me/api/rest_full/v0.3/blogs/379", "title": "Blogs Details", "rel": "resource", "meta": { "component_id": "9088", "component_manifest": "blogs", "space_id": "2888", "space_manifest": "participatory_processes", "resource_id": "379", "action_method": "GET" } }, "collection": { "href": "https://1008.lvh.me/api/rest_full/v0.3/blogs", "title": "Blogs List", "rel": "resource", "meta": { "component_id": "9088", "component_manifest": "blogs", "space_id": "2888", "space_manifest": "participatory_processes", "resource_id": "379", "action_method": "GET" } } }, "meta": { "published": true } } ] } }, "impersonation_ok_draft": { "value": { "data": [ { "id": "346", "type": "blog", "attributes": { "created_at": "2026-08-05T07:21:07Z", "updated_at": "2026-08-05T07:21:07Z", "title": { "en": " Dolorem aspernatur illo. 84767", "fr": " Dolore est molestiae. 84768" }, "body": { "en": "

Quis in qui. 84770

", "fr": "

Tenetur non occaecati. 84771

" }, "published_at": "2026-08-04T07:21:06.876Z" }, "relationships": { "space": { "data": { "id": "2883", "type": "participatory_processes" } }, "component": { "data": { "id": "9083", "type": "blog_component" } } }, "links": { "related": { "href": "https://1003.lvh.me/public/components/9083", "title": " Fuga ut quae. 84757", "rel": "resource", "meta": { "space_id": "2883", "space_manifest": "participatory_processes", "component_id": "9083", "component_manifest": "blogs", "action_method": "GET" } }, "self": { "href": "https://1003.lvh.me/api/rest_full/v0.3/blogs/346", "title": "Blogs Details", "rel": "resource", "meta": { "component_id": "9083", "component_manifest": "blogs", "space_id": "2883", "space_manifest": "participatory_processes", "resource_id": "346", "action_method": "GET" } }, "collection": { "href": "https://1003.lvh.me/api/rest_full/v0.3/blogs", "title": "Blogs List", "rel": "resource", "meta": { "component_id": "9083", "component_manifest": "blogs", "space_id": "2883", "space_manifest": "participatory_processes", "resource_id": "346", "action_method": "GET" } } }, "meta": { "published": true } }, { "id": "350", "type": "blog", "attributes": { "created_at": "2026-08-05T07:21:07Z", "updated_at": "2026-08-05T07:21:07Z", "title": { "en": " Accusamus dolorem alias. 84792", "fr": " Soluta non excepturi. 84793" }, "body": { "en": "

Magni quia harum. 84795

", "fr": "

Eos est iure. 84796

" }, "published_at": "2027-08-05T07:21:07.370Z" }, "relationships": { "space": { "data": { "id": "2883", "type": "participatory_processes" } }, "component": { "data": { "id": "9083", "type": "blog_component" } } }, "links": { "related": { "href": "https://1003.lvh.me/public/components/9083", "title": " Fuga ut quae. 84757", "rel": "resource", "meta": { "space_id": "2883", "space_manifest": "participatory_processes", "component_id": "9083", "component_manifest": "blogs", "action_method": "GET" } }, "self": { "href": "https://1003.lvh.me/api/rest_full/v0.3/blogs/350", "title": "Blogs Details", "rel": "resource", "meta": { "component_id": "9083", "component_manifest": "blogs", "space_id": "2883", "space_manifest": "participatory_processes", "resource_id": "350", "action_method": "GET" } }, "collection": { "href": "https://1003.lvh.me/api/rest_full/v0.3/blogs", "title": "Blogs List", "rel": "resource", "meta": { "component_id": "9083", "component_manifest": "blogs", "space_id": "2883", "space_manifest": "participatory_processes", "resource_id": "350", "action_method": "GET" } } }, "meta": { "published": false } }, { "id": "349", "type": "blog", "attributes": { "created_at": "2026-08-05T07:21:07Z", "updated_at": "2026-08-05T07:21:07Z", "title": { "en": " Ut corporis eaque. 84786", "fr": " Esse provident quod. 84787" }, "body": { "en": "

Dolores autem sint. 84789

", "fr": "

Quod ea et. 84790

" }, "published_at": "2026-08-03T07:21:07.235Z" }, "relationships": { "space": { "data": { "id": "2883", "type": "participatory_processes" } }, "component": { "data": { "id": "9083", "type": "blog_component" } } }, "links": { "related": { "href": "https://1003.lvh.me/public/components/9083", "title": " Fuga ut quae. 84757", "rel": "resource", "meta": { "space_id": "2883", "space_manifest": "participatory_processes", "component_id": "9083", "component_manifest": "blogs", "action_method": "GET" } }, "self": { "href": "https://1003.lvh.me/api/rest_full/v0.3/blogs/349", "title": "Blogs Details", "rel": "resource", "meta": { "component_id": "9083", "component_manifest": "blogs", "space_id": "2883", "space_manifest": "participatory_processes", "resource_id": "349", "action_method": "GET" } }, "collection": { "href": "https://1003.lvh.me/api/rest_full/v0.3/blogs", "title": "Blogs List", "rel": "resource", "meta": { "component_id": "9083", "component_manifest": "blogs", "space_id": "2883", "space_manifest": "participatory_processes", "resource_id": "349", "action_method": "GET" } } }, "meta": { "published": true } }, { "id": "348", "type": "blog", "attributes": { "created_at": "2026-08-05T07:21:07Z", "updated_at": "2026-08-05T07:21:07Z", "title": { "en": " Et quod rerum. 84779", "fr": " Veniam ut qui. 84780" }, "body": { "en": "

Voluptates et adipisci. 84782

", "fr": "

Voluptates libero velit. 84783

" }, "published_at": "2026-08-04T07:21:06.876Z" }, "relationships": { "space": { "data": { "id": "2883", "type": "participatory_processes" } }, "component": { "data": { "id": "9083", "type": "blog_component" } } }, "links": { "related": { "href": "https://1003.lvh.me/public/components/9083", "title": " Fuga ut quae. 84757", "rel": "resource", "meta": { "space_id": "2883", "space_manifest": "participatory_processes", "component_id": "9083", "component_manifest": "blogs", "action_method": "GET" } }, "self": { "href": "https://1003.lvh.me/api/rest_full/v0.3/blogs/348", "title": "Blogs Details", "rel": "resource", "meta": { "component_id": "9083", "component_manifest": "blogs", "space_id": "2883", "space_manifest": "participatory_processes", "resource_id": "348", "action_method": "GET" } }, "collection": { "href": "https://1003.lvh.me/api/rest_full/v0.3/blogs", "title": "Blogs List", "rel": "resource", "meta": { "component_id": "9083", "component_manifest": "blogs", "space_id": "2883", "space_manifest": "participatory_processes", "resource_id": "348", "action_method": "GET" } } }, "meta": { "published": true } }, { "id": "347", "type": "blog", "attributes": { "created_at": "2026-08-05T07:21:07Z", "updated_at": "2026-08-05T07:21:07Z", "title": { "en": " Molestias voluptatem repellendus. 84773", "fr": " Necessitatibus itaque et. 84774" }, "body": { "en": "

Adipisci eum voluptate. 84776

", "fr": "

Error repellendus sit. 84777

" }, "published_at": "2026-08-04T07:21:06.876Z" }, "relationships": { "space": { "data": { "id": "2883", "type": "participatory_processes" } }, "component": { "data": { "id": "9083", "type": "blog_component" } } }, "links": { "related": { "href": "https://1003.lvh.me/public/components/9083", "title": " Fuga ut quae. 84757", "rel": "resource", "meta": { "space_id": "2883", "space_manifest": "participatory_processes", "component_id": "9083", "component_manifest": "blogs", "action_method": "GET" } }, "self": { "href": "https://1003.lvh.me/api/rest_full/v0.3/blogs/347", "title": "Blogs Details", "rel": "resource", "meta": { "component_id": "9083", "component_manifest": "blogs", "space_id": "2883", "space_manifest": "participatory_processes", "resource_id": "347", "action_method": "GET" } }, "collection": { "href": "https://1003.lvh.me/api/rest_full/v0.3/blogs", "title": "Blogs List", "rel": "resource", "meta": { "component_id": "9083", "component_manifest": "blogs", "space_id": "2883", "space_manifest": "participatory_processes", "resource_id": "347", "action_method": "GET" } } }, "meta": { "published": true } } ] } } }, "schema": { "$ref": "#/components/schemas/blog_index_response" } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" }, "examples": { "forbidden_credentialFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } }, "forbidden_impersonationFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } } } } } } } } }, "/draft_proposals/{id}/sync": { "put": { "summary": "Update draft proposal", "tags": [ "Draft Proposals" ], "operationId": "updateDraftProposal", "description": "This endpoint allows you to update a draft proposal associated with your application ID.\nDrafts updated via this API are not visible in the Decidim front-end, and drafts created from the Decidim application are not editable through the API.\nTherefore, any draft you create here is new and tied to your application's credentials.\n\n### Example Request\n\n```http\nPUT /public/assemblies/12/2319/proposals/draft\nContent-Type: application/json\nAuthorization: Bearer YOUR_bearer_token\n\n{\n \"title\": \"My valid title\"\n}\n```\n## Access Requirements\n\n* Authentication: This endpoint requires an impersonation token. You must create drafts on behalf of a participant; drafts cannot be created using a service token (credential_token).\n\n## Error Handling\n\n* Field Errors: Only errors related to the fields you're updating will be returned.\n* Publishable Status: To determine if the draft is publishable, check the data.meta.publishable field in the response.\n\n### Example response\n```json\n{\n \"data\": {\n \"id\": \"12345\",\n \"type\": \"proposal\",\n \"attributes\": {\n \"title\": \"My valid title\",\n \"body\": null\n },\n \"meta\": {\n \"publishable\": false\n }\n }\n}\n```\nIn this example, the title is valid, so the server returns a 200 OK status.\nHowever, since the body is blank, meta.publishable is false, indicating that the draft is not yet ready for publication.\n", "parameters": [ { "name": "id", "in": "path", "schema": { "type": "integer", "description": "Draft Id" }, "required": true }, { "name": "Authorization", "in": "header", "schema": { "type": "string" }, "required": false, "description": "Bearer access token (see security schemes)" } ], "security": [ { "resourceOwnerFlowBearer": [ "proposals" ] } ], "responses": { "403": { "description": "Forbidden", "content": { "application/json": { "examples": { "forbidden_impersonationFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } } }, "schema": { "$ref": "#/components/schemas/error_response" } } } }, "200": { "description": "Draft updated", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/draft_proposal_item_response" }, "examples": { "ok": { "value": { "data": { "id": "4732", "type": "draft_proposal", "attributes": { "created_at": "2026-08-05T07:19:48Z", "updated_at": "2026-08-05T07:19:49Z", "title": { "fr": "This is a valid proposal title sample" }, "body": { "fr": "" }, "errors": { "title": [], "body": [ "Body cannot be blank" ] } }, "relationships": { "space": { "data": { "id": "2868", "type": "participatory_processes" } }, "component": { "data": { "id": "9068", "type": "proposal_component" } }, "author": { "data": { "id": "6115", "type": "user" } }, "coauthors": { "data": [ { "id": "6115", "type": "user" } ], "meta": { "count": 1 } } }, "links": { "related": { "href": "https://962.lvh.me/public/components/9068", "title": " Quia rerum qui. 83179", "rel": "resource", "meta": { "space_id": "2868", "space_manifest": "participatory_processes", "component_id": "9068", "component_manifest": "proposals", "action_method": "GET" } }, "self": { "href": "https://962.lvh.me/api/rest_full/v0.3/proposals/4732", "title": "Proposals Details", "rel": "resource", "meta": { "component_id": "9068", "component_manifest": "proposals", "space_id": "2868", "space_manifest": "participatory_processes", "resource_id": "4732", "action_method": "GET" } }, "collection": { "href": "https://962.lvh.me/api/rest_full/v0.3/proposals", "title": "Proposals List", "rel": "resource", "meta": { "component_id": "9068", "component_manifest": "proposals", "space_id": "2868", "space_manifest": "participatory_processes", "resource_id": "4732", "action_method": "GET" } } }, "meta": { "publishable": false, "client_id": "IezBCZgy8kEPI-tXGlt-Hul6JoqnSRbuXZxAwDqLiLY", "fields": [ "title", "body" ] } } } }, "ok_empty": { "value": { "data": { "id": "4733", "type": "draft_proposal", "attributes": { "created_at": "2026-08-05T07:19:49Z", "updated_at": "2026-08-05T07:19:49Z", "title": {}, "body": {}, "errors": { "title": [ "Title cannot be blank" ], "body": [ "Body cannot be blank" ] } }, "relationships": { "space": { "data": { "id": "2869", "type": "participatory_processes" } }, "component": { "data": { "id": "9069", "type": "proposal_component" } }, "author": { "data": { "id": "6116", "type": "user" } }, "coauthors": { "data": [ { "id": "6116", "type": "user" } ], "meta": { "count": 1 } } }, "links": { "related": { "href": "https://963.lvh.me/public/components/9069", "title": " Quia molestiae non. 83243", "rel": "resource", "meta": { "space_id": "2869", "space_manifest": "participatory_processes", "component_id": "9069", "component_manifest": "proposals", "action_method": "GET" } }, "self": { "href": "https://963.lvh.me/api/rest_full/v0.3/proposals/4733", "title": "Proposals Details", "rel": "resource", "meta": { "component_id": "9069", "component_manifest": "proposals", "space_id": "2869", "space_manifest": "participatory_processes", "resource_id": "4733", "action_method": "GET" } }, "collection": { "href": "https://963.lvh.me/api/rest_full/v0.3/proposals", "title": "Proposals List", "rel": "resource", "meta": { "component_id": "9069", "component_manifest": "proposals", "space_id": "2869", "space_manifest": "participatory_processes", "resource_id": "4733", "action_method": "GET" } } }, "meta": { "publishable": false, "client_id": "vgYb5zqJ3g2sWdD7YabueF7OOSM4E6NP5od1c2rMcOk", "fields": [ "title", "body" ] } } } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } } }, "requestBody": { "content": { "application/json": { "schema": { "type": "object", "title": "Update Draft Proposal Payload", "properties": { "data": { "type": "object", "title": "Update Draft Proposal Payload Data", "properties": { "title": { "type": "string", "description": "Title of the draft" }, "body": { "type": "string", "description": "Content of the draft" }, "locale": { "type": "string", "enum": [ "en", "fr", "es" ], "description": "Locale of the draft. default to user locale" } }, "description": "Payload to update in the proposal" } }, "required": [ "data" ] } } }, "required": true } }, "delete": { "summary": "Withdraw a draft proposal", "tags": [ "Draft Proposals" ], "operationId": "withdrawDraftProposal", "description": "Withdraw (delete) a draft proposal. This action cannot be undone.", "parameters": [ { "name": "id", "in": "path", "schema": { "type": "integer", "description": "Draft Id" }, "required": true }, { "name": "Authorization", "in": "header", "schema": { "type": "string" }, "required": false, "description": "Bearer access token (see security schemes)" } ], "security": [ { "resourceOwnerFlowBearer": [ "proposals" ] } ], "responses": { "200": { "description": "Draft proposal Removed", "content": { "application/json": { "examples": { "ok": { "value": { "data": { "id": "4990", "type": "draft_proposal", "attributes": { "created_at": "2026-08-05T07:25:52Z", "updated_at": "2026-08-05T07:25:52Z", "title": { "fr": " Minus repudiandae officiis. 123846" }, "body": { "fr": "

Quae et et. 123849

" }, "errors": { "title": [], "body": [] } }, "relationships": { "space": { "data": { "id": "3069", "type": "participatory_processes" } }, "component": { "data": { "id": "9743", "type": "proposal_component" } }, "author": { "data": { "id": "6536", "type": "user" } }, "coauthors": { "data": [ { "id": "6536", "type": "user" } ], "meta": { "count": 1 } } }, "links": { "related": { "href": "https://1304.lvh.me/public/components/9743", "title": " Voluptatum voluptatibus vel. 123836", "rel": "resource", "meta": { "space_id": "3069", "space_manifest": "participatory_processes", "component_id": "9743", "component_manifest": "proposals", "action_method": "GET" } }, "self": { "href": "https://1304.lvh.me/api/rest_full/v0.3/proposals/4990", "title": "Proposals Details", "rel": "resource", "meta": { "component_id": "9743", "component_manifest": "proposals", "space_id": "3069", "space_manifest": "participatory_processes", "resource_id": "4990", "action_method": "GET" } }, "collection": { "href": "https://1304.lvh.me/api/rest_full/v0.3/proposals", "title": "Proposals List", "rel": "resource", "meta": { "component_id": "9743", "component_manifest": "proposals", "space_id": "3069", "space_manifest": "participatory_processes", "resource_id": "4990", "action_method": "GET" } } }, "meta": { "publishable": false, "client_id": "u5L_t_PEEXLZXL548H8qR80OF4sLtwxWdp2iHHENn0Y", "fields": [ "title", "body" ] } } } } }, "schema": { "$ref": "#/components/schemas/draft_proposal_item_response" } } } }, "404": { "description": "Not Found", "content": { "application/json": { "examples": { "not_found": { "value": { "error": "404: Resource not found", "error_description": "Resource not found" } } }, "schema": { "$ref": "#/components/schemas/error_response" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "examples": { "forbidden_impersonationFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } } }, "schema": { "$ref": "#/components/schemas/error_response" } } } } } } }, "/users": { "get": { "summary": "List available Users", "tags": [ "Users" ], "operationId": "listUsers", "description": "List or search users of the organization", "parameters": [ { "name": "page", "in": "query", "description": "Page number for pagination", "required": false, "schema": { "type": "integer" } }, { "name": "per_page", "in": "query", "description": "Number of items per page", "required": false, "schema": { "type": "integer" } }, { "name": "filter[nickname_not_in][]", "in": "query", "style": "form", "explode": true, "schema": { "type": "array", "items": { "type": "string" }, "title": "nickname not IN filter", "description": "match none of _nickname_'s values in array" }, "required": false }, { "name": "filter[nickname_in][]", "in": "query", "style": "form", "explode": true, "schema": { "type": "array", "items": { "type": "string" }, "title": "nickname IN filter", "description": "match one of _nickname_'s values in array" }, "required": false }, { "name": "filter[nickname_start]", "in": "query", "schema": { "type": "string", "description": "_nickname_ starts with", "title": "nickname starts With filter", "example": "some_string" }, "required": false }, { "name": "filter[nickname_eq]", "in": "query", "schema": { "type": "string", "title": "nickname equal filter", "description": "_nickname_ is equal to" }, "required": false }, { "name": "filter[nickname_not_eq]", "in": "query", "schema": { "type": "string", "title": "nickname not equal filter", "description": "_nickname_ is NOT equal to" }, "required": false }, { "name": "filter[nickname_matches]", "in": "query", "schema": { "type": "string", "title": "nickname like filter", "description": "matches _nickname_ with `LIKE`", "example": "%some_string" }, "required": false }, { "name": "filter[nickname_blank]", "in": "query", "schema": { "type": "boolean", "title": "nickname blank filter", "description": "_nickname_ is null or empty" }, "required": false }, { "name": "filter[id_in][]", "in": "query", "style": "form", "explode": true, "schema": { "type": "array", "items": { "type": "integer" }, "title": "id IN filter", "description": "match one of _id_'s values in array" }, "required": false }, { "name": "filter[id_eq]", "in": "query", "schema": { "type": "integer", "title": "id equal filter", "description": "_id_ is equal to" }, "required": false }, { "name": "filter[id_lt]", "in": "query", "schema": { "type": "integer", "title": "id less than filter", "description": "_id_ is less than" }, "required": false }, { "name": "filter[id_gt]", "in": "query", "schema": { "type": "integer", "title": "id greater than filter", "description": "_id_ is greater than" }, "required": false }, { "name": "filter[id_present]", "in": "query", "schema": { "type": "boolean", "title": "id present filter", "description": "_id_ is not null and not empty" }, "required": false }, { "name": "filter[id_blank]", "in": "query", "schema": { "type": "boolean", "title": "id blank filter", "description": "_id_ is null or empty" }, "required": false }, { "name": "filter[extended_data_cont]", "schema": { "type": "string" }, "in": "query", "required": false, "example": "\"foo\": \"bar\"", "description": "Search on user extended_data. use the format: `\"\":\"\"`" }, { "name": "Authorization", "in": "header", "schema": { "type": "string" }, "required": false, "description": "Bearer access token (see security schemes)" } ], "security": [ { "credentialFlowBearer": [ "oauth" ] } ], "responses": { "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" }, "examples": { "forbidden_credentialFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } }, "200": { "description": "Users listed", "content": { "application/json": { "examples": { "ok": { "value": { "data": [ { "id": "6125", "type": "user", "attributes": { "name": "Trish Koepp", "nickname": "9_1021", "personal_url": "http://ritchie.test/emmanuel", "email": "user1024@example.org", "about": "Saepe suscipit magnam. 83446", "extended_data": {}, "locale": "en", "created_at": "2026-08-05T07:20:01Z", "updated_at": "2026-08-05T07:20:01Z" }, "relationships": { "roles": { "data": [] } }, "meta": { "blocked": false, "locked": false } }, { "id": "6126", "type": "user", "attributes": { "name": "Mrs. Jo Carter", "nickname": "750bsxtat_1022", "personal_url": "http://reynolds.example/charline.feeney", "email": "user1025@example.org", "about": "Assumenda consectetur amet. 83447", "extended_data": {}, "locale": "en", "created_at": "2026-08-05T07:20:01Z", "updated_at": "2026-08-05T07:20:01Z" }, "relationships": { "roles": { "data": [] } }, "meta": { "blocked": false, "locked": false } }, { "id": "6127", "type": "user", "attributes": { "name": "Deirdre Hackett", "nickname": "wz_1023", "personal_url": "http://damore.example/pauletta.kirlin", "email": "user1026@example.org", "about": "Veritatis eum aut. 83448", "extended_data": {}, "locale": "en", "created_at": "2026-08-05T07:20:01Z", "updated_at": "2026-08-05T07:20:01Z" }, "relationships": { "roles": { "data": [] } }, "meta": { "blocked": false, "locked": false } }, { "id": "6128", "type": "user", "attributes": { "name": "Hollis Erdman", "nickname": "k6_1024", "personal_url": "http://kub.test/lenny.wolf", "email": "user1027@example.org", "about": "Cum nihil rerum. 83449", "extended_data": {}, "locale": "en", "created_at": "2026-08-05T07:20:02Z", "updated_at": "2026-08-05T07:20:02Z" }, "relationships": { "roles": { "data": [] } }, "meta": { "blocked": false, "locked": false } }, { "id": "6129", "type": "user", "attributes": { "name": "Mathilda Schimmel", "nickname": "qqfhoks3b_1025", "personal_url": "http://balistreri-wuckert.example/terrell_smith", "email": "user1028@example.org", "about": "Quas aut dolor. 83450", "extended_data": {}, "locale": "en", "created_at": "2026-08-05T07:20:02Z", "updated_at": "2026-08-05T07:20:02Z" }, "relationships": { "roles": { "data": [] } }, "meta": { "blocked": false, "locked": false } }, { "id": "6130", "type": "user", "attributes": { "name": "Aretha Lubowitz", "nickname": "fk1izyg333_1026", "personal_url": "http://reynolds-bogan.test/erma", "email": "user1029@example.org", "about": "Occaecati libero reiciendis. 83451", "extended_data": {}, "locale": "en", "created_at": "2026-08-05T07:20:02Z", "updated_at": "2026-08-05T07:20:02Z" }, "relationships": { "roles": { "data": [] } }, "meta": { "blocked": false, "locked": false } } ] } }, "filter_by_id_in": { "value": { "data": [ { "id": "6133", "type": "user", "attributes": { "name": "Lesa DAmore", "nickname": "xdkvgwln_1029", "personal_url": "http://kassulke.test/solange_mante", "email": "user1032@example.org", "about": "Magni eligendi occaecati. 83466", "extended_data": {}, "locale": "en", "created_at": "2026-08-05T07:20:02Z", "updated_at": "2026-08-05T07:20:02Z" }, "relationships": { "roles": { "data": [] } }, "meta": { "blocked": false, "locked": false } }, { "id": "6134", "type": "user", "attributes": { "name": "Elodia Cormier", "nickname": "r_1030", "personal_url": "http://rippin.test/nicolas", "email": "user1033@example.org", "about": "Ad blanditiis sed. 83467", "extended_data": {}, "locale": "en", "created_at": "2026-08-05T07:20:02Z", "updated_at": "2026-08-05T07:20:02Z" }, "relationships": { "roles": { "data": [] } }, "meta": { "blocked": false, "locked": false } }, { "id": "6135", "type": "user", "attributes": { "name": "Teresita Daniel", "nickname": "u61ip0lsh2_1031", "personal_url": "http://ortiz.example/celeste", "email": "user1034@example.org", "about": "Qui dolore rerum. 83468", "extended_data": {}, "locale": "en", "created_at": "2026-08-05T07:20:02Z", "updated_at": "2026-08-05T07:20:02Z" }, "relationships": { "roles": { "data": [] } }, "meta": { "blocked": false, "locked": false } }, { "id": "6131", "type": "user", "attributes": { "name": "Shanell Nicolas", "nickname": "2ylub9c8fv_1027", "personal_url": "http://mann.example/wayne_rosenbaum", "email": "user1030@example.org", "about": "Nam aut id. 83464", "extended_data": {}, "locale": "en", "created_at": "2026-08-05T07:20:02Z", "updated_at": "2026-08-05T07:20:02Z" }, "relationships": { "roles": { "data": [] } }, "meta": { "blocked": false, "locked": false } }, { "id": "6132", "type": "user", "attributes": { "name": "Micheal Borer", "nickname": "j0csre3edg_1028", "personal_url": "http://ward.test/shira", "email": "user1031@example.org", "about": "Ipsa fugit eveniet. 83465", "extended_data": {}, "locale": "en", "created_at": "2026-08-05T07:20:02Z", "updated_at": "2026-08-05T07:20:02Z" }, "relationships": { "roles": { "data": [] } }, "meta": { "blocked": false, "locked": false } } ] } }, "ok_paginated": { "value": { "data": [ { "id": "6139", "type": "user", "attributes": { "name": "Major Cronin", "nickname": "b6l687rnwe_1035", "personal_url": "http://lockman.test/gregorio", "email": "user1038@example.org", "about": "Rerum inventore id. 83484", "extended_data": {}, "locale": "en", "created_at": "2026-08-05T07:20:03Z", "updated_at": "2026-08-05T07:20:03Z" }, "relationships": { "roles": { "data": [] } }, "meta": { "blocked": false, "locked": false } }, { "id": "6140", "type": "user", "attributes": { "name": "Harris Rosenbaum", "nickname": "mcppl6prep_1036", "personal_url": "http://deckow-collins.example/odis", "email": "user1039@example.org", "about": "Velit eum ad. 83485", "extended_data": {}, "locale": "en", "created_at": "2026-08-05T07:20:03Z", "updated_at": "2026-08-05T07:20:03Z" }, "relationships": { "roles": { "data": [] } }, "meta": { "blocked": false, "locked": false } }, { "id": "6136", "type": "user", "attributes": { "name": "Daphine Mueller", "nickname": "crxfpcx4_1032", "personal_url": "http://larson.test/antonietta", "email": "user1035@example.org", "about": "Exercitationem quia cum. 83481", "extended_data": {}, "locale": "en", "created_at": "2026-08-05T07:20:03Z", "updated_at": "2026-08-05T07:20:03Z" }, "relationships": { "roles": { "data": [] } }, "meta": { "blocked": false, "locked": false } } ] } }, "user_fr": { "value": { "data": [ { "id": "6147", "type": "user", "attributes": { "name": "Kendrick Harvey", "nickname": "e13y6j7pr_1042", "personal_url": "http://zemlak.example/carrol", "email": "user1046@example.org", "about": "Libero aspernatur expedita. 83516", "extended_data": {}, "locale": "fr", "created_at": "2026-08-05T07:20:05Z", "updated_at": "2026-08-05T07:20:05Z" }, "relationships": { "roles": { "data": [] } }, "meta": { "blocked": false, "locked": false } } ] } }, "filter_by_nickname": { "value": { "data": [ { "id": "6148", "type": "user", "attributes": { "name": "Britany Marvin DDS", "nickname": "blue-panda-218", "personal_url": "http://oberbrunner.test/adrianne", "email": "user1047@example.org", "about": "Laboriosam rem eius. 83529", "extended_data": {}, "locale": "en", "created_at": "2026-08-05T07:20:07Z", "updated_at": "2026-08-05T07:20:07Z" }, "relationships": { "roles": { "data": [] } }, "meta": { "blocked": false, "locked": false } } ] } }, "filter_by_extended_data": { "value": { "data": [ { "id": "6160", "type": "user", "attributes": { "name": "Dylan Franecki", "nickname": "specific-data", "personal_url": "http://mueller.example/gaston.hartmann", "email": "user1059@example.org", "about": "Similique beatae nisi. 83565", "extended_data": { "key": { "is": "awesome" } }, "locale": "en", "created_at": "2026-08-05T07:20:09Z", "updated_at": "2026-08-05T07:20:09Z" }, "relationships": { "roles": { "data": [] } }, "meta": { "blocked": false, "locked": false } } ] } }, "paginated": { "value": { "data": [ { "id": "6168", "type": "user", "attributes": { "name": "Rev. Morris Beier", "nickname": "3_1060", "personal_url": "http://hodkiewicz-von.test/refugio.ernser", "email": "user1067@example.org", "about": "Aut omnis vel. 83585", "extended_data": {}, "locale": "en", "created_at": "2026-08-05T07:20:10Z", "updated_at": "2026-08-05T07:20:10Z" }, "relationships": { "roles": { "data": [] } }, "meta": { "blocked": false, "locked": false } }, { "id": "6166", "type": "user", "attributes": { "name": "Stewart Bernhard JD", "nickname": "4w002o_1058", "personal_url": "http://daugherty-johnson.example/lanelle_mcglynn", "email": "user1065@example.org", "about": "Ea quia consequatur. 83583", "extended_data": {}, "locale": "en", "created_at": "2026-08-05T07:20:10Z", "updated_at": "2026-08-05T07:20:10Z" }, "relationships": { "roles": { "data": [] } }, "meta": { "blocked": false, "locked": false } } ] } } }, "schema": { "$ref": "#/components/schemas/user_index_response" } } } }, "401": { "description": "Unauthorized when no Bearer token", "content": { "application/json": { "examples": { "unauthorized": { "value": { "error": "401: Unauthorized access", "error_description": "Unauthorized access" } } }, "schema": { "$ref": "#/components/schemas/error_response" } } } } } } }, "/jobs": { "get": { "summary": "List API jobs", "tags": [ "Jobs" ], "operationId": "listJobs", "description": "Returns async jobs for the same OAuth application, resource owner (when applicable), and organization as the Bearer token used to originate those jobs.\n\n### Pagination\n`page` defaults to `1`; `per_page` defaults to `25` and is clamped to **100**.\n\n### Filters\n- `filter[command_key]`: job name (e.g. `draft_proposals#create`, `forms/questions#create`)\n- `filter[status]`: `pending`, `processing`, `completed`, or `failed`\n\n### Conditional GET\nSupports `ETag` / `If-None-Match` on the collection.\n\n### Access\nBearer token required (same OAuth context as the jobs being listed).\n", "parameters": [ { "name": "filter[command_key_not_in][]", "in": "query", "style": "form", "explode": true, "schema": { "type": "array", "items": { "type": "string" }, "title": "command_key not IN filter", "description": "match none of _command_key_'s values in array" }, "required": false }, { "name": "filter[command_key_in][]", "in": "query", "style": "form", "explode": true, "schema": { "type": "array", "items": { "type": "string" }, "title": "command_key IN filter", "description": "match one of _command_key_'s values in array" }, "required": false }, { "name": "filter[command_key_start]", "in": "query", "schema": { "type": "string", "description": "_command_key_ starts with", "title": "command_key starts With filter", "example": "some_string" }, "required": false }, { "name": "filter[command_key_eq]", "in": "query", "schema": { "type": "string", "title": "command_key equal filter", "description": "_command_key_ is equal to" }, "required": false }, { "name": "filter[command_key_not_eq]", "in": "query", "schema": { "type": "string", "title": "command_key not equal filter", "description": "_command_key_ is NOT equal to" }, "required": false }, { "name": "filter[command_key_matches]", "in": "query", "schema": { "type": "string", "title": "command_key like filter", "description": "matches _command_key_ with `LIKE`", "example": "%some_string" }, "required": false }, { "name": "filter[command_key_blank]", "in": "query", "schema": { "type": "boolean", "title": "command_key blank filter", "description": "_command_key_ is null or empty" }, "required": false }, { "name": "filter[status_not_in][]", "in": "query", "style": "form", "explode": true, "schema": { "type": "array", "items": { "type": "string", "enum": [ "pending", "processing", "completed", "failed" ] }, "title": "status not IN filter", "description": "match none of _status_'s values in array" }, "required": false }, { "name": "filter[status_in][]", "in": "query", "style": "form", "explode": true, "schema": { "type": "array", "items": { "type": "string", "enum": [ "pending", "processing", "completed", "failed" ] }, "title": "status IN filter", "description": "match one of _status_'s values in array" }, "required": false }, { "name": "filter[status_start]", "in": "query", "schema": { "type": "string", "description": "_status_ starts with", "title": "status starts With filter", "example": "some_string" }, "required": false }, { "name": "filter[status_eq]", "in": "query", "schema": { "type": "string", "enum": [ "pending", "processing", "completed", "failed" ], "title": "status equal filter", "description": "_status_ is equal to" }, "required": false }, { "name": "filter[status_not_eq]", "in": "query", "schema": { "type": "string", "enum": [ "pending", "processing", "completed", "failed" ], "title": "status not equal filter", "description": "_status_ is NOT equal to" }, "required": false }, { "name": "filter[status_matches]", "in": "query", "schema": { "type": "string", "title": "status like filter", "description": "matches _status_ with `LIKE`", "example": "%some_string" }, "required": false }, { "name": "filter[status_blank]", "in": "query", "schema": { "type": "boolean", "title": "status blank filter", "description": "_status_ is null or empty" }, "required": false }, { "name": "Authorization", "in": "header", "required": true, "description": "Bearer access token: `Bearer `", "schema": { "type": "string" } }, { "name": "page", "in": "query", "description": "Page number for pagination", "required": false, "schema": { "type": "integer" } }, { "name": "per_page", "in": "query", "description": "Number of items per page", "required": false, "schema": { "type": "integer" } } ], "security": [], "responses": { "200": { "description": "jobs listed for oauth context", "content": { "application/json": { "examples": { "ok_index": { "value": { "data": [ { "id": "161fa07a-172c-4d04-a80a-62b8d3855a76", "status": "completed", "command_key": "draft_proposals#create", "created_at": "2026-08-05T07:20:30.045Z", "updated_at": "2026-08-05T07:20:30.045Z", "links": { "self": { "href": "https://983.lvh.me/api/rest_full/v0.3/jobs/161fa07a-172c-4d04-a80a-62b8d3855a76", "title": "API job status", "rel": "resource", "meta": { "action_method": "GET" } } } } ], "meta": { "page": 1, "per_page": 25 } } } }, "schema": { "$ref": "#/components/schemas/rest_full_api_jobs_index_response" } } } }, "401": { "description": "Unauthorized when Bearer missing", "content": { "application/json": { "examples": { "jobs_index_unauthenticated": { "value": { "error": "401: Unauthorized access", "error_description": "Unauthorized access" } } }, "schema": { "$ref": "#/components/schemas/error_response" } } } } } } }, "/organizations/{id}": { "get": { "summary": "Organization", "tags": [ "Organizations" ], "operationId": "getOrganization", "description": "Show organization", "parameters": [ { "name": "locales[]", "in": "query", "style": "form", "explode": true, "schema": { "type": "array", "title": "Available locales", "description": "List of locale codes the organization exposes.", "items": { "$ref": "#/components/schemas/locale" } }, "required": false }, { "name": "id", "in": "path", "required": true, "description": "The ID of the organization", "schema": { "type": "string" } }, { "name": "Authorization", "in": "header", "schema": { "type": "string" }, "required": false, "description": "Bearer access token (see security schemes)" } ], "security": [ { "credentialFlowBearer": [ "system" ] } ], "responses": { "404": { "description": "Organization Not Found", "content": { "application/json": { "examples": { "not_found": { "value": { "error": "404: Record not found", "error_description": "Record not found" } } }, "schema": { "$ref": "#/components/schemas/error_response" } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "examples": { "forbidden_credentialFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } } }, "schema": { "$ref": "#/components/schemas/error_response" } } } }, "200": { "description": "Organization shown", "content": { "application/json": { "examples": { "ok": { "value": { "data": { "id": "1912", "type": "organization", "attributes": { "host": "989.lvh.me", "secondary_hosts": [], "default_locale": "en", "available_locales": [ "en" ], "enable_machine_translations": false, "badges_enabled": true, "rich_text_editor_in_public_views": false, "comments_max_length": 1000, "time_zone": "UTC", "users_registration_mode": "enabled", "force_users_to_authenticate_before_access_organization": false, "reference_prefix": "DVM", "send_welcome_notification": true, "enable_participatory_space_filters": false, "user_groups_enabled": false, "name": { "en": "Pfeffer-Ferry", "fr": "Doyle, Bogisich and Schimmel" }, "description": { "en": "

Reiciendis adipisci molestiae. 83726

", "fr": "

Consequatur ducimus aut. 83727

" }, "extended_data": {}, "created_at": "2026-08-05T07:20:46Z", "updated_at": "2026-08-05T07:20:46Z" }, "meta": { "locales": [ "en", "fr" ] } } } } }, "schema": { "$ref": "#/components/schemas/organization_item_response" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } } } } }, "/draft_proposals/sync": { "post": { "summary": "Create draft proposal", "tags": [ "Draft Proposals" ], "operationId": "createDraftProposal", "description": "Create a draft\n", "parameters": [ { "name": "Authorization", "in": "header", "schema": { "type": "string" }, "required": false, "description": "Bearer access token (see security schemes)" } ], "security": [ { "resourceOwnerFlowBearer": [ "proposals" ] } ], "responses": { "200": { "description": "Draft updated", "content": { "application/json": { "examples": { "ok_empty": { "value": { "data": { "id": "4737", "type": "draft_proposal", "attributes": { "created_at": "2026-08-05T07:21:33Z", "updated_at": "2026-08-05T07:21:33Z", "title": {}, "body": {}, "errors": { "title": [ "Title cannot be blank" ], "body": [ "Body cannot be blank" ] } }, "relationships": { "space": { "data": { "id": "2895", "type": "participatory_processes" } }, "component": { "data": { "id": "9095", "type": "proposal_component" } }, "author": { "data": { "id": "6265", "type": "user" } }, "coauthors": { "data": [ { "id": "6265", "type": "user" } ], "meta": { "count": 1 } } }, "links": { "related": { "href": "https://1015.lvh.me/public/components/9095", "title": " A unde corrupti. 85805", "rel": "resource", "meta": { "space_id": "2895", "space_manifest": "participatory_processes", "component_id": "9095", "component_manifest": "proposals", "action_method": "GET" } }, "self": { "href": "https://1015.lvh.me/api/rest_full/v0.3/proposals/4737", "title": "Proposals Details", "rel": "resource", "meta": { "component_id": "9095", "component_manifest": "proposals", "space_id": "2895", "space_manifest": "participatory_processes", "resource_id": "4737", "action_method": "GET" } }, "collection": { "href": "https://1015.lvh.me/api/rest_full/v0.3/proposals", "title": "Proposals List", "rel": "resource", "meta": { "component_id": "9095", "component_manifest": "proposals", "space_id": "2895", "space_manifest": "participatory_processes", "resource_id": "4737", "action_method": "GET" } } }, "meta": { "publishable": false, "client_id": "r7IaGpuyEpqt-XaTC4_6w7UI2ufHQGoC63jED27dv8A", "fields": [ "title", "body" ] } } } } }, "schema": { "$ref": "#/components/schemas/draft_proposal_item_response" } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" }, "examples": { "forbidden_impersonationFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } } } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } }, "404": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } } }, "requestBody": { "content": { "application/json": { "schema": { "type": "object", "title": "Create Draft Proposal Payload", "properties": { "data": { "type": "object", "title": "Draft Proposal Data", "properties": { "component_id": { "type": "integer", "description": "Component ID" } }, "required": [ "component_id" ], "description": "Payload to update in the proposal" } }, "required": [ "data" ] } } }, "required": true } } }, "/spaces/search": { "get": { "summary": "Search Participatory Spaces", "tags": [ "Spaces" ], "operationId": "searchSpaces", "description": "List or search spaces of the organization. Can be processes, assemblies, or any other registred participatory space.", "parameters": [ { "name": "locales[]", "in": "query", "style": "form", "explode": true, "schema": { "type": "array", "title": "Available locales", "description": "List of locale codes the organization exposes.", "items": { "$ref": "#/components/schemas/locale" } }, "required": false }, { "name": "page", "in": "query", "description": "Page number for pagination", "required": false, "schema": { "type": "integer" } }, { "name": "per_page", "in": "query", "description": "Number of items per page", "required": false, "schema": { "type": "integer" } }, { "name": "filter[manifest_name_not_in][]", "in": "query", "style": "form", "explode": true, "schema": { "type": "array", "items": { "type": "string", "enum": [ "participatory_processes", "assemblies", "conferences", "initiatives" ] }, "title": "manifest_name not IN filter", "description": "match none of _manifest_name_'s values in array" }, "required": false }, { "name": "filter[manifest_name_in][]", "in": "query", "style": "form", "explode": true, "schema": { "type": "array", "items": { "type": "string", "enum": [ "participatory_processes", "assemblies", "conferences", "initiatives" ] }, "title": "manifest_name IN filter", "description": "match one of _manifest_name_'s values in array" }, "required": false }, { "name": "filter[manifest_name_start]", "in": "query", "schema": { "type": "string", "description": "_manifest_name_ starts with", "title": "manifest_name starts With filter", "example": "some_string" }, "required": false }, { "name": "filter[manifest_name_eq]", "in": "query", "schema": { "type": "string", "enum": [ "participatory_processes", "assemblies", "conferences", "initiatives" ], "title": "manifest_name equal filter", "description": "_manifest_name_ is equal to" }, "required": false }, { "name": "filter[manifest_name_not_eq]", "in": "query", "schema": { "type": "string", "enum": [ "participatory_processes", "assemblies", "conferences", "initiatives" ], "title": "manifest_name not equal filter", "description": "_manifest_name_ is NOT equal to" }, "required": false }, { "name": "filter[manifest_name_matches]", "in": "query", "schema": { "type": "string", "title": "manifest_name like filter", "description": "matches _manifest_name_ with `LIKE`", "example": "%some_string" }, "required": false }, { "name": "filter[manifest_name_blank]", "in": "query", "schema": { "type": "boolean", "title": "manifest_name blank filter", "description": "_manifest_name_ is null or empty" }, "required": false }, { "name": "filter[id_in][]", "in": "query", "style": "form", "explode": true, "schema": { "type": "array", "items": { "type": "integer" }, "title": "id IN filter", "description": "match one of _id_'s values in array" }, "required": false }, { "name": "filter[id_eq]", "in": "query", "schema": { "type": "integer", "title": "id equal filter", "description": "_id_ is equal to" }, "required": false }, { "name": "filter[id_lt]", "in": "query", "schema": { "type": "integer", "title": "id less than filter", "description": "_id_ is less than" }, "required": false }, { "name": "filter[id_gt]", "in": "query", "schema": { "type": "integer", "title": "id greater than filter", "description": "_id_ is greater than" }, "required": false }, { "name": "filter[id_present]", "in": "query", "schema": { "type": "boolean", "title": "id present filter", "description": "_id_ is not null and not empty" }, "required": false }, { "name": "filter[id_blank]", "in": "query", "schema": { "type": "boolean", "title": "id blank filter", "description": "_id_ is null or empty" }, "required": false }, { "name": "filter[slug_not_in][]", "in": "query", "style": "form", "explode": true, "schema": { "type": "array", "items": { "type": "string" }, "title": "slug not IN filter", "description": "match none of _slug_'s values in array" }, "required": false }, { "name": "filter[slug_in][]", "in": "query", "style": "form", "explode": true, "schema": { "type": "array", "items": { "type": "string" }, "title": "slug IN filter", "description": "match one of _slug_'s values in array" }, "required": false }, { "name": "filter[slug_start]", "in": "query", "schema": { "type": "string", "description": "_slug_ starts with", "title": "slug starts With filter", "example": "some_string" }, "required": false }, { "name": "filter[slug_eq]", "in": "query", "schema": { "type": "string", "title": "slug equal filter", "description": "_slug_ is equal to" }, "required": false }, { "name": "filter[slug_not_eq]", "in": "query", "schema": { "type": "string", "title": "slug not equal filter", "description": "_slug_ is NOT equal to" }, "required": false }, { "name": "filter[slug_matches]", "in": "query", "schema": { "type": "string", "title": "slug like filter", "description": "matches _slug_ with `LIKE`", "example": "%some_string" }, "required": false }, { "name": "filter[slug_blank]", "in": "query", "schema": { "type": "boolean", "title": "slug blank filter", "description": "_slug_ is null or empty" }, "required": false }, { "name": "filter[title_not_in][]", "in": "query", "style": "form", "explode": true, "schema": { "type": "array", "items": { "type": "string" }, "title": "title not IN filter", "description": "match none of _title_'s values in array" }, "required": false }, { "name": "filter[title_in][]", "in": "query", "style": "form", "explode": true, "schema": { "type": "array", "items": { "type": "string" }, "title": "title IN filter", "description": "match one of _title_'s values in array" }, "required": false }, { "name": "filter[title_start]", "in": "query", "schema": { "type": "string", "description": "_title_ starts with", "title": "title starts With filter", "example": "some_string" }, "required": false }, { "name": "filter[title_eq]", "in": "query", "schema": { "type": "string", "title": "title equal filter", "description": "_title_ is equal to" }, "required": false }, { "name": "filter[title_not_eq]", "in": "query", "schema": { "type": "string", "title": "title not equal filter", "description": "_title_ is NOT equal to" }, "required": false }, { "name": "filter[title_matches]", "in": "query", "schema": { "type": "string", "title": "title like filter", "description": "matches _title_ with `LIKE`", "example": "%some_string" }, "required": false }, { "name": "filter[title_blank]", "in": "query", "schema": { "type": "boolean", "title": "title blank filter", "description": "_title_ is null or empty" }, "required": false }, { "name": "filter[extended_data_cont]", "in": "query", "schema": { "type": "string" }, "required": false, "description": "Search on space extended_data. Requires `public.space.extended_data.read`. See [Extended data](https://octree-gva.github.io/decidim-rest-full/integrator/extended-data)." }, { "name": "Authorization", "in": "header", "schema": { "type": "string" }, "required": false, "description": "Bearer access token (see security schemes)" } ], "security": [ { "resourceOwnerFlowBearer": [ "public" ] } ], "responses": { "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } }, "403": { "description": "Forbidden when filtering extended_data without permission", "content": { "application/json": { "examples": { "filter_extended_data_forbidden": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } }, "forbidden_credentialFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } }, "forbidden_impersonationFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } } }, "schema": { "$ref": "#/components/schemas/error_response" } } } }, "200": { "description": "Search Results", "content": { "application/json": { "examples": { "search_translatable_text": { "value": { "data": [ { "id": "2267", "type": "space", "attributes": { "manifest_name": "assemblies", "participatory_space_type": "Decidim::Assembly", "title": { "en": "My assembly for testing purpose", "fr": "c'est une assemblée" }, "subtitle": { "en": " Magni quaerat atque. 109450", "fr": " Odit architecto vero. 109451" }, "short_description": { "en": "

Sit quia assumenda. 109453

", "fr": "

Similique voluptate omnis. 109454

" }, "description": { "en": "

Occaecati sunt aspernatur. 109456

", "fr": "

Incidunt voluptatem voluptas. 109457

" }, "visibility": "transparent", "created_at": "2026-08-05T07:23:41Z", "updated_at": "2026-08-05T07:23:41Z" }, "relationships": { "components": { "data": [ { "id": "9501", "type": "proposal_component" }, { "id": "9502", "type": "meeting_component" }, { "id": "9503", "type": "proposal_component" }, { "id": "9504", "type": "meeting_component" }, { "id": "9505", "type": "proposal_component" }, { "id": "9506", "type": "meeting_component" }, { "id": "9507", "type": "page_component" }, { "id": "9508", "type": "proposal_component" }, { "id": "9509", "type": "meeting_component" }, { "id": "9510", "type": "budget_component" }, { "id": "9511", "type": "survey_component" }, { "id": "9512", "type": "accountability_component" }, { "id": "9513", "type": "debate_component" }, { "id": "9514", "type": "blog_component" }, { "id": "9515", "type": "awesome_map_component" }, { "id": "9516", "type": "awesome_iframe_component" } ], "meta": { "count": 16 }, "links": { "self": { "href": "https://1196.lvh.me/api/rest_full/v0.3/public/components?filter[participatory_space_type_eq]=Decidim::Assembly&filter[participatory_space_id_eq]=2267", "title": "Component list for this space", "rel": "resource", "meta": { "space_manifest": "assemblies", "space_id": "2267", "action_method": "GET" } } } } }, "links": { "self": { "href": "https://1196.lvh.me/public/assemblies/2267", "title": "en", "rel": "resource", "meta": { "space_id": "2267", "space_manifest": "assemblies", "action_method": "GET" } }, "related": { "href": "https://1196.lvh.me/system/organizations/1969", "title": "Mraz Group", "rel": "resource", "meta": { "action_method": "GET" } } } } ] } }, "filter_by_extended_data_miss": { "value": { "data": [] } }, "filter_by_extended_data": { "value": { "data": [ { "id": "3003", "type": "space", "attributes": { "manifest_name": "participatory_processes", "participatory_space_type": "Decidim::ParticipatoryProcess", "title": { "en": " Voluptas sequi iste. 109317", "fr": " Autem architecto laudantium. 109318" }, "subtitle": { "en": " Autem similique nostrum. 109320", "fr": " Dolor ipsum dolores. 109321" }, "short_description": { "en": "

Dolores dolorem impedit. 109323

", "fr": "

Ea tempore cum. 109324

" }, "description": { "en": "

Sit repellendus error. 109326

", "fr": "

Mollitia assumenda molestias. 109327

" }, "visibility": "public", "extended_data": { "region": "west" }, "created_at": "2026-08-05T07:23:41Z", "updated_at": "2026-08-05T07:23:41Z" }, "relationships": { "components": { "data": [], "meta": { "count": 0 }, "links": { "self": { "href": "https://1189.lvh.me/api/rest_full/v0.3/public/components?filter[participatory_space_type_eq]=Decidim::ParticipatoryProcess&filter[participatory_space_id_eq]=3003", "title": "Component list for this space", "rel": "resource", "meta": { "space_manifest": "participatory_processes", "space_id": "3003", "action_method": "GET" } } } } }, "links": { "self": { "href": "https://1189.lvh.me/public/participatory_processes/3003", "title": "en", "rel": "resource", "meta": { "space_id": "3003", "space_manifest": "participatory_processes", "action_method": "GET" } }, "related": { "href": "https://1189.lvh.me/system/organizations/1968", "title": "Cronin, Cronin and Hayes", "rel": "resource", "meta": { "action_method": "GET" } } } } ] } }, "manifest_name_in_Assemblies": { "value": { "data": [ { "id": "2321", "type": "space", "attributes": { "manifest_name": "assemblies", "participatory_space_type": "Decidim::Assembly", "title": { "en": "My assembly for testing purpose", "fr": "c'est une assemblée" }, "subtitle": { "en": " Aliquid reprehenderit repellat. 120000", "fr": " Laborum nostrum qui. 120001" }, "short_description": { "en": "

Numquam nihil nisi. 120003

", "fr": "

Ipsa eaque aut. 120004

" }, "description": { "en": "

Dignissimos minima distinctio. 120006

", "fr": "

Perferendis omnis sapiente. 120007

" }, "visibility": "transparent", "created_at": "2026-08-05T07:24:45Z", "updated_at": "2026-08-05T07:24:45Z" }, "relationships": { "components": { "data": [ { "id": "9677", "type": "proposal_component" }, { "id": "9678", "type": "meeting_component" }, { "id": "9679", "type": "proposal_component" }, { "id": "9680", "type": "meeting_component" }, { "id": "9681", "type": "proposal_component" }, { "id": "9682", "type": "meeting_component" }, { "id": "9683", "type": "page_component" }, { "id": "9684", "type": "proposal_component" }, { "id": "9685", "type": "meeting_component" }, { "id": "9686", "type": "budget_component" }, { "id": "9687", "type": "survey_component" }, { "id": "9688", "type": "accountability_component" }, { "id": "9689", "type": "debate_component" }, { "id": "9690", "type": "blog_component" }, { "id": "9691", "type": "awesome_map_component" }, { "id": "9692", "type": "awesome_iframe_component" } ], "meta": { "count": 16 }, "links": { "self": { "href": "https://1273.lvh.me/api/rest_full/v0.3/public/components?filter[participatory_space_type_eq]=Decidim::Assembly&filter[participatory_space_id_eq]=2321", "title": "Component list for this space", "rel": "resource", "meta": { "space_manifest": "assemblies", "space_id": "2321", "action_method": "GET" } } } } }, "links": { "self": { "href": "https://1273.lvh.me/public/assemblies/2321", "title": "en", "rel": "resource", "meta": { "space_id": "2321", "space_manifest": "assemblies", "action_method": "GET" } }, "related": { "href": "https://1273.lvh.me/system/organizations/1980", "title": "Koelpin-Daniel", "rel": "resource", "meta": { "action_method": "GET" } } } }, { "id": "2322", "type": "space", "attributes": { "manifest_name": "assemblies", "participatory_space_type": "Decidim::Assembly", "title": { "en": " Earum animi ipsa. 120552", "fr": " Dolores laudantium quis. 120553" }, "subtitle": { "en": " Dolore facilis minus. 120555", "fr": " Labore modi odit. 120556" }, "short_description": { "en": "

Quam voluptates reiciendis. 120558

", "fr": "

Magnam quam molestias. 120559

" }, "description": { "en": "

Facere laborum earum. 120561

", "fr": "

Dolorum ea voluptates. 120562

" }, "visibility": "transparent", "created_at": "2026-08-05T07:24:48Z", "updated_at": "2026-08-05T07:24:48Z" }, "relationships": { "components": { "data": [], "meta": { "count": 0 }, "links": { "self": { "href": "https://1273.lvh.me/api/rest_full/v0.3/public/components?filter[participatory_space_type_eq]=Decidim::Assembly&filter[participatory_space_id_eq]=2322", "title": "Component list for this space", "rel": "resource", "meta": { "space_manifest": "assemblies", "space_id": "2322", "action_method": "GET" } } } } }, "links": { "self": { "href": "https://1273.lvh.me/public/assemblies/2322", "title": "en", "rel": "resource", "meta": { "space_id": "2322", "space_manifest": "assemblies", "action_method": "GET" } }, "related": { "href": "https://1273.lvh.me/system/organizations/1980", "title": "Koelpin-Daniel", "rel": "resource", "meta": { "action_method": "GET" } } } }, { "id": "2323", "type": "space", "attributes": { "manifest_name": "assemblies", "participatory_space_type": "Decidim::Assembly", "title": { "en": " Velit aut non. 120627", "fr": " Voluptatum voluptatem sunt. 120628" }, "subtitle": { "en": " Dolor expedita sed. 120630", "fr": " Ea sit quae. 120631" }, "short_description": { "en": "

Aspernatur cumque rerum. 120633

", "fr": "

Rerum laboriosam ut. 120634

" }, "description": { "en": "

Ipsam optio maiores. 120636

", "fr": "

Veritatis omnis sapiente. 120637

" }, "visibility": "transparent", "created_at": "2026-08-05T07:24:48Z", "updated_at": "2026-08-05T07:24:48Z" }, "relationships": { "components": { "data": [], "meta": { "count": 0 }, "links": { "self": { "href": "https://1273.lvh.me/api/rest_full/v0.3/public/components?filter[participatory_space_type_eq]=Decidim::Assembly&filter[participatory_space_id_eq]=2323", "title": "Component list for this space", "rel": "resource", "meta": { "space_manifest": "assemblies", "space_id": "2323", "action_method": "GET" } } } } }, "links": { "self": { "href": "https://1273.lvh.me/public/assemblies/2323", "title": "en", "rel": "resource", "meta": { "space_id": "2323", "space_manifest": "assemblies", "action_method": "GET" } }, "related": { "href": "https://1273.lvh.me/system/organizations/1980", "title": "Koelpin-Daniel", "rel": "resource", "meta": { "action_method": "GET" } } } }, { "id": "2324", "type": "space", "attributes": { "manifest_name": "assemblies", "participatory_space_type": "Decidim::Assembly", "title": { "en": " Adipisci qui blanditiis. 120702", "fr": " Aliquid sed omnis. 120703" }, "subtitle": { "en": " Distinctio omnis ut. 120705", "fr": " Quia qui dicta. 120706" }, "short_description": { "en": "

Temporibus quia voluptate. 120708

", "fr": "

Eius voluptas fuga. 120709

" }, "description": { "en": "

Aut sit quia. 120711

", "fr": "

Sit quia cumque. 120712

" }, "visibility": "transparent", "created_at": "2026-08-05T07:24:48Z", "updated_at": "2026-08-05T07:24:48Z" }, "relationships": { "components": { "data": [], "meta": { "count": 0 }, "links": { "self": { "href": "https://1273.lvh.me/api/rest_full/v0.3/public/components?filter[participatory_space_type_eq]=Decidim::Assembly&filter[participatory_space_id_eq]=2324", "title": "Component list for this space", "rel": "resource", "meta": { "space_manifest": "assemblies", "space_id": "2324", "action_method": "GET" } } } } }, "links": { "self": { "href": "https://1273.lvh.me/public/assemblies/2324", "title": "en", "rel": "resource", "meta": { "space_id": "2324", "space_manifest": "assemblies", "action_method": "GET" } }, "related": { "href": "https://1273.lvh.me/system/organizations/1980", "title": "Koelpin-Daniel", "rel": "resource", "meta": { "action_method": "GET" } } } } ] } }, "ok": { "value": { "data": [ { "id": "2259", "type": "space", "attributes": { "manifest_name": "assemblies", "participatory_space_type": "Decidim::Assembly", "title": { "en": "My assembly for testing purpose", "fr": "c'est une assemblée" }, "subtitle": { "en": " Esse ipsam vitae. 107630", "fr": " Quae aspernatur perferendis. 107631" }, "short_description": { "en": "

Repudiandae modi provident. 107633

", "fr": "

Accusamus magni similique. 107634

" }, "description": { "en": "

Dolore et enim. 107636

", "fr": "

Accusamus dolorem sed. 107637

" }, "visibility": "transparent", "created_at": "2026-08-05T07:23:32Z", "updated_at": "2026-08-05T07:23:32Z" }, "relationships": { "components": { "data": [ { "id": "9469", "type": "proposal_component" }, { "id": "9470", "type": "meeting_component" }, { "id": "9471", "type": "proposal_component" }, { "id": "9472", "type": "meeting_component" }, { "id": "9473", "type": "proposal_component" }, { "id": "9474", "type": "meeting_component" }, { "id": "9475", "type": "page_component" }, { "id": "9476", "type": "proposal_component" }, { "id": "9477", "type": "meeting_component" }, { "id": "9478", "type": "budget_component" }, { "id": "9479", "type": "survey_component" }, { "id": "9480", "type": "accountability_component" }, { "id": "9481", "type": "debate_component" }, { "id": "9482", "type": "blog_component" }, { "id": "9483", "type": "awesome_map_component" }, { "id": "9484", "type": "awesome_iframe_component" } ], "meta": { "count": 16 }, "links": { "self": { "href": "https://1182.lvh.me/api/rest_full/v0.3/public/components?filter[participatory_space_type_eq]=Decidim::Assembly&filter[participatory_space_id_eq]=2259", "title": "Component list for this space", "rel": "resource", "meta": { "space_manifest": "assemblies", "space_id": "2259", "action_method": "GET" } } } } }, "links": { "self": { "href": "https://1182.lvh.me/public/assemblies/2259", "title": "en", "rel": "resource", "meta": { "space_id": "2259", "space_manifest": "assemblies", "action_method": "GET" } }, "related": { "href": "https://1182.lvh.me/system/organizations/1967", "title": "Effertz, Marks and Murphy", "rel": "resource", "meta": { "action_method": "GET" } } } }, { "id": "2260", "type": "space", "attributes": { "manifest_name": "assemblies", "participatory_space_type": "Decidim::Assembly", "title": { "en": " Minus aut quo. 108182", "fr": " Laboriosam accusantium sequi. 108183" }, "subtitle": { "en": " Adipisci nam ducimus. 108185", "fr": " Dolorem id quo. 108186" }, "short_description": { "en": "

Non et consequatur. 108188

", "fr": "

Ut cumque ea. 108189

" }, "description": { "en": "

Et velit dolorem. 108191

", "fr": "

Maiores dolor nulla. 108192

" }, "visibility": "transparent", "created_at": "2026-08-05T07:23:35Z", "updated_at": "2026-08-05T07:23:35Z" }, "relationships": { "components": { "data": [], "meta": { "count": 0 }, "links": { "self": { "href": "https://1182.lvh.me/api/rest_full/v0.3/public/components?filter[participatory_space_type_eq]=Decidim::Assembly&filter[participatory_space_id_eq]=2260", "title": "Component list for this space", "rel": "resource", "meta": { "space_manifest": "assemblies", "space_id": "2260", "action_method": "GET" } } } } }, "links": { "self": { "href": "https://1182.lvh.me/public/assemblies/2260", "title": "en", "rel": "resource", "meta": { "space_id": "2260", "space_manifest": "assemblies", "action_method": "GET" } }, "related": { "href": "https://1182.lvh.me/system/organizations/1967", "title": "Effertz, Marks and Murphy", "rel": "resource", "meta": { "action_method": "GET" } } } }, { "id": "2996", "type": "space", "attributes": { "manifest_name": "participatory_processes", "participatory_space_type": "Decidim::ParticipatoryProcess", "title": { "en": " Ut repudiandae blanditiis. 108227", "fr": " Aspernatur dolorem id. 108228" }, "subtitle": { "en": " Voluptas sit facere. 108230", "fr": " Eveniet voluptates similique. 108231" }, "short_description": { "en": "

Rerum veniam quasi. 108233

", "fr": "

Numquam maxime quis. 108234

" }, "description": { "en": "

Tenetur nemo et. 108236

", "fr": "

Eos ipsa consequatur. 108237

" }, "visibility": "public", "created_at": "2026-08-05T07:23:35Z", "updated_at": "2026-08-05T07:23:36Z" }, "relationships": { "components": { "data": [], "meta": { "count": 0 }, "links": { "self": { "href": "https://1182.lvh.me/api/rest_full/v0.3/public/components?filter[participatory_space_type_eq]=Decidim::ParticipatoryProcess&filter[participatory_space_id_eq]=2996", "title": "Component list for this space", "rel": "resource", "meta": { "space_manifest": "participatory_processes", "space_id": "2996", "action_method": "GET" } } } } }, "links": { "self": { "href": "https://1182.lvh.me/public/participatory_processes/2996", "title": "en", "rel": "resource", "meta": { "space_id": "2996", "space_manifest": "participatory_processes", "action_method": "GET" } }, "related": { "href": "https://1182.lvh.me/system/organizations/1967", "title": "Effertz, Marks and Murphy", "rel": "resource", "meta": { "action_method": "GET" } } } }, { "id": "2261", "type": "space", "attributes": { "manifest_name": "assemblies", "participatory_space_type": "Decidim::Assembly", "title": { "en": " Modi nihil accusamus. 108257", "fr": " Vel voluptatem exercitationem. 108258" }, "subtitle": { "en": " Recusandae fuga odio. 108260", "fr": " Enim ut exercitationem. 108261" }, "short_description": { "en": "

Et praesentium beatae. 108263

", "fr": "

Eos impedit hic. 108264

" }, "description": { "en": "

Repudiandae facilis labore. 108266

", "fr": "

Nostrum sunt molestias. 108267

" }, "visibility": "transparent", "created_at": "2026-08-05T07:23:36Z", "updated_at": "2026-08-05T07:23:36Z" }, "relationships": { "components": { "data": [], "meta": { "count": 0 }, "links": { "self": { "href": "https://1182.lvh.me/api/rest_full/v0.3/public/components?filter[participatory_space_type_eq]=Decidim::Assembly&filter[participatory_space_id_eq]=2261", "title": "Component list for this space", "rel": "resource", "meta": { "space_manifest": "assemblies", "space_id": "2261", "action_method": "GET" } } } } }, "links": { "self": { "href": "https://1182.lvh.me/public/assemblies/2261", "title": "en", "rel": "resource", "meta": { "space_id": "2261", "space_manifest": "assemblies", "action_method": "GET" } }, "related": { "href": "https://1182.lvh.me/system/organizations/1967", "title": "Effertz, Marks and Murphy", "rel": "resource", "meta": { "action_method": "GET" } } } }, { "id": "2997", "type": "space", "attributes": { "manifest_name": "participatory_processes", "participatory_space_type": "Decidim::ParticipatoryProcess", "title": { "en": " Ullam consequuntur consequatur. 108302", "fr": " Illo aspernatur ad. 108303" }, "subtitle": { "en": " Sit voluptatem dolor. 108305", "fr": " Iste veritatis hic. 108306" }, "short_description": { "en": "

Sed ad quibusdam. 108308

", "fr": "

Eum odio quis. 108309

" }, "description": { "en": "

Ut quod et. 108311

", "fr": "

Occaecati quo recusandae. 108312

" }, "visibility": "public", "created_at": "2026-08-05T07:23:36Z", "updated_at": "2026-08-05T07:23:36Z" }, "relationships": { "components": { "data": [], "meta": { "count": 0 }, "links": { "self": { "href": "https://1182.lvh.me/api/rest_full/v0.3/public/components?filter[participatory_space_type_eq]=Decidim::ParticipatoryProcess&filter[participatory_space_id_eq]=2997", "title": "Component list for this space", "rel": "resource", "meta": { "space_manifest": "participatory_processes", "space_id": "2997", "action_method": "GET" } } } } }, "links": { "self": { "href": "https://1182.lvh.me/public/participatory_processes/2997", "title": "en", "rel": "resource", "meta": { "space_id": "2997", "space_manifest": "participatory_processes", "action_method": "GET" } }, "related": { "href": "https://1182.lvh.me/system/organizations/1967", "title": "Effertz, Marks and Murphy", "rel": "resource", "meta": { "action_method": "GET" } } } }, { "id": "2262", "type": "space", "attributes": { "manifest_name": "assemblies", "participatory_space_type": "Decidim::Assembly", "title": { "en": " Et porro quaerat. 108332", "fr": " Voluptatem molestias ducimus. 108333" }, "subtitle": { "en": " Corporis a ipsa. 108335", "fr": " Quis eius quo. 108336" }, "short_description": { "en": "

Repellat neque beatae. 108338

", "fr": "

Quasi aut distinctio. 108339

" }, "description": { "en": "

Ipsa et vel. 108341

", "fr": "

Non aut et. 108342

" }, "visibility": "transparent", "created_at": "2026-08-05T07:23:36Z", "updated_at": "2026-08-05T07:23:36Z" }, "relationships": { "components": { "data": [], "meta": { "count": 0 }, "links": { "self": { "href": "https://1182.lvh.me/api/rest_full/v0.3/public/components?filter[participatory_space_type_eq]=Decidim::Assembly&filter[participatory_space_id_eq]=2262", "title": "Component list for this space", "rel": "resource", "meta": { "space_manifest": "assemblies", "space_id": "2262", "action_method": "GET" } } } } }, "links": { "self": { "href": "https://1182.lvh.me/public/assemblies/2262", "title": "en", "rel": "resource", "meta": { "space_id": "2262", "space_manifest": "assemblies", "action_method": "GET" } }, "related": { "href": "https://1182.lvh.me/system/organizations/1967", "title": "Effertz, Marks and Murphy", "rel": "resource", "meta": { "action_method": "GET" } } } }, { "id": "2998", "type": "space", "attributes": { "manifest_name": "participatory_processes", "participatory_space_type": "Decidim::ParticipatoryProcess", "title": { "en": " Quo consequatur nulla. 108377", "fr": " Qui qui voluptatibus. 108378" }, "subtitle": { "en": " Reiciendis autem quasi. 108380", "fr": " Ut quis velit. 108381" }, "short_description": { "en": "

Dolorem sint explicabo. 108383

", "fr": "

Enim est et. 108384

" }, "description": { "en": "

Dignissimos reprehenderit unde. 108386

", "fr": "

Dignissimos quo dicta. 108387

" }, "visibility": "public", "created_at": "2026-08-05T07:23:36Z", "updated_at": "2026-08-05T07:23:36Z" }, "relationships": { "components": { "data": [], "meta": { "count": 0 }, "links": { "self": { "href": "https://1182.lvh.me/api/rest_full/v0.3/public/components?filter[participatory_space_type_eq]=Decidim::ParticipatoryProcess&filter[participatory_space_id_eq]=2998", "title": "Component list for this space", "rel": "resource", "meta": { "space_manifest": "participatory_processes", "space_id": "2998", "action_method": "GET" } } } } }, "links": { "self": { "href": "https://1182.lvh.me/public/participatory_processes/2998", "title": "en", "rel": "resource", "meta": { "space_id": "2998", "space_manifest": "participatory_processes", "action_method": "GET" } }, "related": { "href": "https://1182.lvh.me/system/organizations/1967", "title": "Effertz, Marks and Murphy", "rel": "resource", "meta": { "action_method": "GET" } } } }, { "id": "2999", "type": "space", "attributes": { "manifest_name": "participatory_processes", "participatory_space_type": "Decidim::ParticipatoryProcess", "title": { "en": " Iure labore officiis. 108407", "fr": " Voluptate blanditiis eius. 108408" }, "subtitle": { "en": " Omnis veniam iure. 108410", "fr": " Voluptas eius et. 108411" }, "short_description": { "en": "

Dolore veniam incidunt. 108413

", "fr": "

Reiciendis est et. 108414

" }, "description": { "en": "

Quia sit sunt. 108416

", "fr": "

Cumque molestiae porro. 108417

" }, "visibility": "public", "created_at": "2026-08-05T07:23:36Z", "updated_at": "2026-08-05T07:23:36Z" }, "relationships": { "components": { "data": [], "meta": { "count": 0 }, "links": { "self": { "href": "https://1182.lvh.me/api/rest_full/v0.3/public/components?filter[participatory_space_type_eq]=Decidim::ParticipatoryProcess&filter[participatory_space_id_eq]=2999", "title": "Component list for this space", "rel": "resource", "meta": { "space_manifest": "participatory_processes", "space_id": "2999", "action_method": "GET" } } } } }, "links": { "self": { "href": "https://1182.lvh.me/public/participatory_processes/2999", "title": "en", "rel": "resource", "meta": { "space_id": "2999", "space_manifest": "participatory_processes", "action_method": "GET" } }, "related": { "href": "https://1182.lvh.me/system/organizations/1967", "title": "Effertz, Marks and Murphy", "rel": "resource", "meta": { "action_method": "GET" } } } } ] } }, "filter_by_manifest_name_eq": { "value": { "data": [ { "id": "2283", "type": "space", "attributes": { "manifest_name": "assemblies", "participatory_space_type": "Decidim::Assembly", "title": { "en": "My assembly for testing purpose", "fr": "c'est une assemblée" }, "subtitle": { "en": " Ab et voluptas. 113150", "fr": " Blanditiis corrupti ad. 113151" }, "short_description": { "en": "

Et porro sint. 113153

", "fr": "

Quis minus itaque. 113154

" }, "description": { "en": "

Odio numquam velit. 113156

", "fr": "

Ut quia labore. 113157

" }, "visibility": "transparent", "created_at": "2026-08-05T07:24:01Z", "updated_at": "2026-08-05T07:24:01Z" }, "relationships": { "components": { "data": [ { "id": "9565", "type": "proposal_component" }, { "id": "9566", "type": "meeting_component" }, { "id": "9567", "type": "proposal_component" }, { "id": "9568", "type": "meeting_component" }, { "id": "9569", "type": "proposal_component" }, { "id": "9570", "type": "meeting_component" }, { "id": "9571", "type": "page_component" }, { "id": "9572", "type": "proposal_component" }, { "id": "9573", "type": "meeting_component" }, { "id": "9574", "type": "budget_component" }, { "id": "9575", "type": "survey_component" }, { "id": "9576", "type": "accountability_component" }, { "id": "9577", "type": "debate_component" }, { "id": "9578", "type": "blog_component" }, { "id": "9579", "type": "awesome_map_component" }, { "id": "9580", "type": "awesome_iframe_component" } ], "meta": { "count": 16 }, "links": { "self": { "href": "https://1224.lvh.me/api/rest_full/v0.3/public/components?filter[participatory_space_type_eq]=Decidim::Assembly&filter[participatory_space_id_eq]=2283", "title": "Component list for this space", "rel": "resource", "meta": { "space_manifest": "assemblies", "space_id": "2283", "action_method": "GET" } } } } }, "links": { "self": { "href": "https://1224.lvh.me/public/assemblies/2283", "title": "en", "rel": "resource", "meta": { "space_id": "2283", "space_manifest": "assemblies", "action_method": "GET" } }, "related": { "href": "https://1224.lvh.me/system/organizations/1973", "title": "Runolfsdottir-Bins", "rel": "resource", "meta": { "action_method": "GET" } } } }, { "id": "2284", "type": "space", "attributes": { "manifest_name": "assemblies", "participatory_space_type": "Decidim::Assembly", "title": { "en": " Nihil commodi ut. 113702", "fr": " Eveniet aut eaque. 113703" }, "subtitle": { "en": " Et sed nesciunt. 113705", "fr": " Non voluptate molestiae. 113706" }, "short_description": { "en": "

Id atque consequatur. 113708

", "fr": "

Nostrum similique consequatur. 113709

" }, "description": { "en": "

Nihil fuga molestiae. 113711

", "fr": "

Omnis natus similique. 113712

" }, "visibility": "transparent", "created_at": "2026-08-05T07:24:04Z", "updated_at": "2026-08-05T07:24:04Z" }, "relationships": { "components": { "data": [], "meta": { "count": 0 }, "links": { "self": { "href": "https://1224.lvh.me/api/rest_full/v0.3/public/components?filter[participatory_space_type_eq]=Decidim::Assembly&filter[participatory_space_id_eq]=2284", "title": "Component list for this space", "rel": "resource", "meta": { "space_manifest": "assemblies", "space_id": "2284", "action_method": "GET" } } } } }, "links": { "self": { "href": "https://1224.lvh.me/public/assemblies/2284", "title": "en", "rel": "resource", "meta": { "space_id": "2284", "space_manifest": "assemblies", "action_method": "GET" } }, "related": { "href": "https://1224.lvh.me/system/organizations/1973", "title": "Runolfsdottir-Bins", "rel": "resource", "meta": { "action_method": "GET" } } } }, { "id": "2285", "type": "space", "attributes": { "manifest_name": "assemblies", "participatory_space_type": "Decidim::Assembly", "title": { "en": " Aut earum molestias. 113777", "fr": " Aliquid voluptatibus quia. 113778" }, "subtitle": { "en": " Laboriosam quia libero. 113780", "fr": " Voluptas velit est. 113781" }, "short_description": { "en": "

Quis odio architecto. 113783

", "fr": "

Et aut nihil. 113784

" }, "description": { "en": "

Sapiente assumenda reiciendis. 113786

", "fr": "

Possimus fuga aut. 113787

" }, "visibility": "transparent", "created_at": "2026-08-05T07:24:05Z", "updated_at": "2026-08-05T07:24:05Z" }, "relationships": { "components": { "data": [], "meta": { "count": 0 }, "links": { "self": { "href": "https://1224.lvh.me/api/rest_full/v0.3/public/components?filter[participatory_space_type_eq]=Decidim::Assembly&filter[participatory_space_id_eq]=2285", "title": "Component list for this space", "rel": "resource", "meta": { "space_manifest": "assemblies", "space_id": "2285", "action_method": "GET" } } } } }, "links": { "self": { "href": "https://1224.lvh.me/public/assemblies/2285", "title": "en", "rel": "resource", "meta": { "space_id": "2285", "space_manifest": "assemblies", "action_method": "GET" } }, "related": { "href": "https://1224.lvh.me/system/organizations/1973", "title": "Runolfsdottir-Bins", "rel": "resource", "meta": { "action_method": "GET" } } } }, { "id": "2286", "type": "space", "attributes": { "manifest_name": "assemblies", "participatory_space_type": "Decidim::Assembly", "title": { "en": " Sint esse non. 113852", "fr": " Commodi dolorum porro. 113853" }, "subtitle": { "en": " Deserunt similique et. 113855", "fr": " Molestiae voluptatem sed. 113856" }, "short_description": { "en": "

Voluptates quam qui. 113858

", "fr": "

Aut culpa ut. 113859

" }, "description": { "en": "

Praesentium et doloribus. 113861

", "fr": "

Quia amet consequuntur. 113862

" }, "visibility": "transparent", "created_at": "2026-08-05T07:24:05Z", "updated_at": "2026-08-05T07:24:05Z" }, "relationships": { "components": { "data": [], "meta": { "count": 0 }, "links": { "self": { "href": "https://1224.lvh.me/api/rest_full/v0.3/public/components?filter[participatory_space_type_eq]=Decidim::Assembly&filter[participatory_space_id_eq]=2286", "title": "Component list for this space", "rel": "resource", "meta": { "space_manifest": "assemblies", "space_id": "2286", "action_method": "GET" } } } } }, "links": { "self": { "href": "https://1224.lvh.me/public/assemblies/2286", "title": "en", "rel": "resource", "meta": { "space_id": "2286", "space_manifest": "assemblies", "action_method": "GET" } }, "related": { "href": "https://1224.lvh.me/system/organizations/1973", "title": "Runolfsdottir-Bins", "rel": "resource", "meta": { "action_method": "GET" } } } } ] } }, "filter_by_slug_eq": { "value": { "data": [ { "id": "3011", "type": "space", "attributes": { "manifest_name": "participatory_processes", "participatory_space_type": "Decidim::ParticipatoryProcess", "title": { "en": " Quae et dolor. 111137", "fr": " Esse quibusdam error. 111138" }, "subtitle": { "en": " Minima voluptatem suscipit. 111140", "fr": " Laborum eos ipsum. 111141" }, "short_description": { "en": "

Et non ut. 111143

", "fr": "

Ullam sunt et. 111144

" }, "description": { "en": "

Qui nemo qui. 111146

", "fr": "

Perferendis molestiae molestiae. 111147

" }, "visibility": "public", "created_at": "2026-08-05T07:23:49Z", "updated_at": "2026-08-05T07:23:49Z" }, "relationships": { "components": { "data": [], "meta": { "count": 0 }, "links": { "self": { "href": "https://1203.lvh.me/api/rest_full/v0.3/public/components?filter[participatory_space_type_eq]=Decidim::ParticipatoryProcess&filter[participatory_space_id_eq]=3011", "title": "Component list for this space", "rel": "resource", "meta": { "space_manifest": "participatory_processes", "space_id": "3011", "action_method": "GET" } } } } }, "links": { "self": { "href": "https://1203.lvh.me/public/participatory_processes/3011", "title": "en", "rel": "resource", "meta": { "space_id": "3011", "space_manifest": "participatory_processes", "action_method": "GET" } }, "related": { "href": "https://1203.lvh.me/system/organizations/1970", "title": "Ratke-Jacobs", "rel": "resource", "meta": { "action_method": "GET" } } } } ] } }, "filter_by_id_eq": { "value": { "data": [ { "id": "2325", "type": "space", "attributes": { "manifest_name": "assemblies", "participatory_space_type": "Decidim::Assembly", "title": { "en": "My assembly for testing purpose" }, "subtitle": { "en": " Voluptatem temporibus nulla. 120910" }, "short_description": { "en": "

Tenetur rerum consequuntur. 120913

" }, "description": { "en": "

Sint exercitationem iure. 120916

" }, "visibility": "transparent", "created_at": "2026-08-05T07:24:50Z", "updated_at": "2026-08-05T07:24:50Z" }, "relationships": { "components": { "data": [ { "id": "9693", "type": "proposal_component" }, { "id": "9694", "type": "meeting_component" }, { "id": "9695", "type": "proposal_component" }, { "id": "9696", "type": "meeting_component" }, { "id": "9697", "type": "proposal_component" }, { "id": "9698", "type": "meeting_component" }, { "id": "9699", "type": "page_component" }, { "id": "9700", "type": "proposal_component" }, { "id": "9701", "type": "meeting_component" }, { "id": "9702", "type": "budget_component" }, { "id": "9703", "type": "survey_component" }, { "id": "9704", "type": "accountability_component" }, { "id": "9705", "type": "debate_component" }, { "id": "9706", "type": "blog_component" }, { "id": "9707", "type": "awesome_map_component" }, { "id": "9708", "type": "awesome_iframe_component" } ], "meta": { "count": 16 }, "links": { "self": { "href": "https://1280.lvh.me/api/rest_full/v0.3/public/components?filter[participatory_space_type_eq]=Decidim::Assembly&filter[participatory_space_id_eq]=2325", "title": "Component list for this space", "rel": "resource", "meta": { "space_manifest": "assemblies", "space_id": "2325", "action_method": "GET" } } } } }, "links": { "self": { "href": "https://1280.lvh.me/public/assemblies/2325", "title": "en", "rel": "resource", "meta": { "space_id": "2325", "space_manifest": "assemblies", "action_method": "GET" } }, "related": { "href": "https://1280.lvh.me/system/organizations/1981", "title": "Schuppe, Fritsch and Brekke", "rel": "resource", "meta": { "action_method": "GET" } } } } ] } }, "paginated": { "value": { "data": [ { "id": "2318", "type": "space", "attributes": { "manifest_name": "assemblies", "participatory_space_type": "Decidim::Assembly", "title": { "en": " Voluptas possimus distinctio. 119852", "fr": " Iusto blanditiis officia. 119853" }, "subtitle": { "en": " Et quos quo. 119855", "fr": " Asperiores quas et. 119856" }, "short_description": { "en": "

Modi est quis. 119858

", "fr": "

Vitae est possimus. 119859

" }, "description": { "en": "

Omnis voluptas vitae. 119861

", "fr": "

Dolor eum autem. 119862

" }, "visibility": "transparent", "created_at": "2026-08-05T07:24:44Z", "updated_at": "2026-08-05T07:24:44Z" }, "relationships": { "components": { "data": [], "meta": { "count": 0 }, "links": { "self": { "href": "https://1266.lvh.me/api/rest_full/v0.3/public/components?filter[participatory_space_type_eq]=Decidim::Assembly&filter[participatory_space_id_eq]=2318", "title": "Component list for this space", "rel": "resource", "meta": { "space_manifest": "assemblies", "space_id": "2318", "action_method": "GET" } } } } }, "links": { "self": { "href": "https://1266.lvh.me/public/assemblies/2318", "title": "en", "rel": "resource", "meta": { "space_id": "2318", "space_manifest": "assemblies", "action_method": "GET" } }, "related": { "href": "https://1266.lvh.me/system/organizations/1979", "title": "McGlynn, Ortiz and Runolfsdottir", "rel": "resource", "meta": { "action_method": "GET" } } } }, { "id": "2319", "type": "space", "attributes": { "manifest_name": "assemblies", "participatory_space_type": "Decidim::Assembly", "title": { "en": " Accusamus et iste. 119897", "fr": " Ab nesciunt adipisci. 119898" }, "subtitle": { "en": " Aperiam fuga molestiae. 119900", "fr": " Consequatur quod enim. 119901" }, "short_description": { "en": "

Culpa commodi aut. 119903

", "fr": "

Qui et nisi. 119904

" }, "description": { "en": "

Fugiat autem veniam. 119906

", "fr": "

Animi sit unde. 119907

" }, "visibility": "transparent", "created_at": "2026-08-05T07:24:44Z", "updated_at": "2026-08-05T07:24:44Z" }, "relationships": { "components": { "data": [], "meta": { "count": 0 }, "links": { "self": { "href": "https://1266.lvh.me/api/rest_full/v0.3/public/components?filter[participatory_space_type_eq]=Decidim::Assembly&filter[participatory_space_id_eq]=2319", "title": "Component list for this space", "rel": "resource", "meta": { "space_manifest": "assemblies", "space_id": "2319", "action_method": "GET" } } } } }, "links": { "self": { "href": "https://1266.lvh.me/public/assemblies/2319", "title": "en", "rel": "resource", "meta": { "space_id": "2319", "space_manifest": "assemblies", "action_method": "GET" } }, "related": { "href": "https://1266.lvh.me/system/organizations/1979", "title": "McGlynn, Ortiz and Runolfsdottir", "rel": "resource", "meta": { "action_method": "GET" } } } } ] } }, "filter_by_id_in": { "value": { "data": [ { "id": "2293", "type": "space", "attributes": { "manifest_name": "assemblies", "participatory_space_type": "Decidim::Assembly", "title": { "en": " Omnis ut possimus. 115597" }, "subtitle": { "en": " Aut libero ut. 115600" }, "short_description": { "en": "

Rerum modi cumque. 115603

" }, "description": { "en": "

Laudantium aut sunt. 115606

" }, "visibility": "transparent", "created_at": "2026-08-05T07:24:15Z", "updated_at": "2026-08-05T07:24:15Z" }, "relationships": { "components": { "data": [], "meta": { "count": 0 }, "links": { "self": { "href": "https://1238.lvh.me/api/rest_full/v0.3/public/components?filter[participatory_space_type_eq]=Decidim::Assembly&filter[participatory_space_id_eq]=2293", "title": "Component list for this space", "rel": "resource", "meta": { "space_manifest": "assemblies", "space_id": "2293", "action_method": "GET" } } } } }, "links": { "self": { "href": "https://1238.lvh.me/public/assemblies/2293", "title": "en", "rel": "resource", "meta": { "space_id": "2293", "space_manifest": "assemblies", "action_method": "GET" } }, "related": { "href": "https://1238.lvh.me/system/organizations/1975", "title": "Emard, Botsford and Stroman", "rel": "resource", "meta": { "action_method": "GET" } } } }, { "id": "3031", "type": "space", "attributes": { "manifest_name": "participatory_processes", "participatory_space_type": "Decidim::ParticipatoryProcess", "title": { "en": " In voluptatem sed. 115642" }, "subtitle": { "en": " Qui aperiam natus. 115645" }, "short_description": { "en": "

Sapiente nihil ullam. 115648

" }, "description": { "en": "

Cum odio dolorem. 115651

" }, "visibility": "public", "created_at": "2026-08-05T07:24:15Z", "updated_at": "2026-08-05T07:24:15Z" }, "relationships": { "components": { "data": [], "meta": { "count": 0 }, "links": { "self": { "href": "https://1238.lvh.me/api/rest_full/v0.3/public/components?filter[participatory_space_type_eq]=Decidim::ParticipatoryProcess&filter[participatory_space_id_eq]=3031", "title": "Component list for this space", "rel": "resource", "meta": { "space_manifest": "participatory_processes", "space_id": "3031", "action_method": "GET" } } } } }, "links": { "self": { "href": "https://1238.lvh.me/public/participatory_processes/3031", "title": "en", "rel": "resource", "meta": { "space_id": "3031", "space_manifest": "participatory_processes", "action_method": "GET" } }, "related": { "href": "https://1238.lvh.me/system/organizations/1975", "title": "Emard, Botsford and Stroman", "rel": "resource", "meta": { "action_method": "GET" } } } }, { "id": "2294", "type": "space", "attributes": { "manifest_name": "assemblies", "participatory_space_type": "Decidim::Assembly", "title": { "en": " Laborum optio est. 115672" }, "subtitle": { "en": " Illum itaque consequatur. 115675" }, "short_description": { "en": "

Fugit hic porro. 115678

" }, "description": { "en": "

Vero quaerat et. 115681

" }, "visibility": "transparent", "created_at": "2026-08-05T07:24:15Z", "updated_at": "2026-08-05T07:24:15Z" }, "relationships": { "components": { "data": [], "meta": { "count": 0 }, "links": { "self": { "href": "https://1238.lvh.me/api/rest_full/v0.3/public/components?filter[participatory_space_type_eq]=Decidim::Assembly&filter[participatory_space_id_eq]=2294", "title": "Component list for this space", "rel": "resource", "meta": { "space_manifest": "assemblies", "space_id": "2294", "action_method": "GET" } } } } }, "links": { "self": { "href": "https://1238.lvh.me/public/assemblies/2294", "title": "en", "rel": "resource", "meta": { "space_id": "2294", "space_manifest": "assemblies", "action_method": "GET" } }, "related": { "href": "https://1238.lvh.me/system/organizations/1975", "title": "Emard, Botsford and Stroman", "rel": "resource", "meta": { "action_method": "GET" } } } }, { "id": "3032", "type": "space", "attributes": { "manifest_name": "participatory_processes", "participatory_space_type": "Decidim::ParticipatoryProcess", "title": { "en": " Sapiente reiciendis facere. 115717" }, "subtitle": { "en": " Quibusdam veritatis dolor. 115720" }, "short_description": { "en": "

Maxime quibusdam et. 115723

" }, "description": { "en": "

Vitae deserunt nesciunt. 115726

" }, "visibility": "public", "created_at": "2026-08-05T07:24:15Z", "updated_at": "2026-08-05T07:24:15Z" }, "relationships": { "components": { "data": [], "meta": { "count": 0 }, "links": { "self": { "href": "https://1238.lvh.me/api/rest_full/v0.3/public/components?filter[participatory_space_type_eq]=Decidim::ParticipatoryProcess&filter[participatory_space_id_eq]=3032", "title": "Component list for this space", "rel": "resource", "meta": { "space_manifest": "participatory_processes", "space_id": "3032", "action_method": "GET" } } } } }, "links": { "self": { "href": "https://1238.lvh.me/public/participatory_processes/3032", "title": "en", "rel": "resource", "meta": { "space_id": "3032", "space_manifest": "participatory_processes", "action_method": "GET" } }, "related": { "href": "https://1238.lvh.me/system/organizations/1975", "title": "Emard, Botsford and Stroman", "rel": "resource", "meta": { "action_method": "GET" } } } }, { "id": "2295", "type": "space", "attributes": { "manifest_name": "assemblies", "participatory_space_type": "Decidim::Assembly", "title": { "en": " Odio vitae ut. 115747" }, "subtitle": { "en": " In sunt numquam. 115750" }, "short_description": { "en": "

Molestiae et et. 115753

" }, "description": { "en": "

Est fugit reiciendis. 115756

" }, "visibility": "transparent", "created_at": "2026-08-05T07:24:15Z", "updated_at": "2026-08-05T07:24:15Z" }, "relationships": { "components": { "data": [], "meta": { "count": 0 }, "links": { "self": { "href": "https://1238.lvh.me/api/rest_full/v0.3/public/components?filter[participatory_space_type_eq]=Decidim::Assembly&filter[participatory_space_id_eq]=2295", "title": "Component list for this space", "rel": "resource", "meta": { "space_manifest": "assemblies", "space_id": "2295", "action_method": "GET" } } } } }, "links": { "self": { "href": "https://1238.lvh.me/public/assemblies/2295", "title": "en", "rel": "resource", "meta": { "space_id": "2295", "space_manifest": "assemblies", "action_method": "GET" } }, "related": { "href": "https://1238.lvh.me/system/organizations/1975", "title": "Emard, Botsford and Stroman", "rel": "resource", "meta": { "action_method": "GET" } } } }, { "id": "3033", "type": "space", "attributes": { "manifest_name": "participatory_processes", "participatory_space_type": "Decidim::ParticipatoryProcess", "title": { "en": " Id quas optio. 115792" }, "subtitle": { "en": " Quos corporis ipsa. 115795" }, "short_description": { "en": "

Doloribus voluptatum aut. 115798

" }, "description": { "en": "

Modi nisi id. 115801

" }, "visibility": "public", "created_at": "2026-08-05T07:24:15Z", "updated_at": "2026-08-05T07:24:15Z" }, "relationships": { "components": { "data": [], "meta": { "count": 0 }, "links": { "self": { "href": "https://1238.lvh.me/api/rest_full/v0.3/public/components?filter[participatory_space_type_eq]=Decidim::ParticipatoryProcess&filter[participatory_space_id_eq]=3033", "title": "Component list for this space", "rel": "resource", "meta": { "space_manifest": "participatory_processes", "space_id": "3033", "action_method": "GET" } } } } }, "links": { "self": { "href": "https://1238.lvh.me/public/participatory_processes/3033", "title": "en", "rel": "resource", "meta": { "space_id": "3033", "space_manifest": "participatory_processes", "action_method": "GET" } }, "related": { "href": "https://1238.lvh.me/system/organizations/1975", "title": "Emard, Botsford and Stroman", "rel": "resource", "meta": { "action_method": "GET" } } } } ] } }, "filter_by_slug_matches_prefix": { "value": { "data": [ { "id": "3016", "type": "space", "attributes": { "manifest_name": "participatory_processes", "participatory_space_type": "Decidim::ParticipatoryProcess", "title": { "en": " Nisi provident quisquam. 112167", "fr": " Officia quasi repudiandae. 112168" }, "subtitle": { "en": " Est minus alias. 112170", "fr": " Quos et quis. 112171" }, "short_description": { "en": "

Doloremque exercitationem architecto. 112173

", "fr": "

Non maiores fugit. 112174

" }, "description": { "en": "

Laboriosam esse voluptates. 112176

", "fr": "

Ullam temporibus eaque. 112177

" }, "visibility": "public", "created_at": "2026-08-05T07:23:54Z", "updated_at": "2026-08-05T07:23:54Z" }, "relationships": { "components": { "data": [], "meta": { "count": 0 }, "links": { "self": { "href": "https://1210.lvh.me/api/rest_full/v0.3/public/components?filter[participatory_space_type_eq]=Decidim::ParticipatoryProcess&filter[participatory_space_id_eq]=3016", "title": "Component list for this space", "rel": "resource", "meta": { "space_manifest": "participatory_processes", "space_id": "3016", "action_method": "GET" } } } } }, "links": { "self": { "href": "https://1210.lvh.me/public/participatory_processes/3016", "title": "en", "rel": "resource", "meta": { "space_id": "3016", "space_manifest": "participatory_processes", "action_method": "GET" } }, "related": { "href": "https://1210.lvh.me/system/organizations/1971", "title": "McCullough, Ondricka and Medhurst", "rel": "resource", "meta": { "action_method": "GET" } } } }, { "id": "3017", "type": "space", "attributes": { "manifest_name": "participatory_processes", "participatory_space_type": "Decidim::ParticipatoryProcess", "title": { "en": " Quia porro sapiente. 112197", "fr": " Dolores esse voluptas. 112198" }, "subtitle": { "en": " Assumenda voluptatem at. 112200", "fr": " Doloremque voluptatem velit. 112201" }, "short_description": { "en": "

Recusandae eos voluptas. 112203

", "fr": "

Quibusdam voluptatum quia. 112204

" }, "description": { "en": "

Qui exercitationem commodi. 112206

", "fr": "

Qui quo molestiae. 112207

" }, "visibility": "public", "created_at": "2026-08-05T07:23:54Z", "updated_at": "2026-08-05T07:23:55Z" }, "relationships": { "components": { "data": [], "meta": { "count": 0 }, "links": { "self": { "href": "https://1210.lvh.me/api/rest_full/v0.3/public/components?filter[participatory_space_type_eq]=Decidim::ParticipatoryProcess&filter[participatory_space_id_eq]=3017", "title": "Component list for this space", "rel": "resource", "meta": { "space_manifest": "participatory_processes", "space_id": "3017", "action_method": "GET" } } } } }, "links": { "self": { "href": "https://1210.lvh.me/public/participatory_processes/3017", "title": "en", "rel": "resource", "meta": { "space_id": "3017", "space_manifest": "participatory_processes", "action_method": "GET" } }, "related": { "href": "https://1210.lvh.me/system/organizations/1971", "title": "McCullough, Ondricka and Medhurst", "rel": "resource", "meta": { "action_method": "GET" } } } } ] } }, "filter_by_id_eq_returns_both_space_types": { "value": { "data": [ { "id": "1", "type": "space", "attributes": { "manifest_name": "assemblies", "participatory_space_type": "Decidim::Assembly", "title": { "en": " Atque dolores qui. 114957", "fr": " Assumenda labore harum. 114958" }, "subtitle": { "en": " Rerum in quo. 114960", "fr": " Et distinctio earum. 114961" }, "short_description": { "en": "

Consequatur occaecati odit. 114963

", "fr": "

Modi sit nostrum. 114964

" }, "description": { "en": "

Sequi ipsum perspiciatis. 114966

", "fr": "

Eveniet neque culpa. 114967

" }, "visibility": "transparent", "created_at": "2026-08-05T07:24:12Z", "updated_at": "2026-08-05T07:24:12Z" }, "relationships": { "components": { "data": [], "meta": { "count": 0 }, "links": { "self": { "href": "https://1231.lvh.me/api/rest_full/v0.3/public/components?filter[participatory_space_type_eq]=Decidim::Assembly&filter[participatory_space_id_eq]=1", "title": "Component list for this space", "rel": "resource", "meta": { "space_manifest": "assemblies", "space_id": "1", "action_method": "GET" } } } } }, "links": { "self": { "href": "https://1231.lvh.me/public/assemblies/1", "title": "en", "rel": "resource", "meta": { "space_id": "1", "space_manifest": "assemblies", "action_method": "GET" } }, "related": { "href": "https://1231.lvh.me/system/organizations/1974", "title": "Lesch-Lemke", "rel": "resource", "meta": { "action_method": "GET" } } } }, { "id": "1", "type": "space", "attributes": { "manifest_name": "participatory_processes", "participatory_space_type": "Decidim::ParticipatoryProcess", "title": { "en": " Blanditiis aliquid sed. 115002", "fr": " Nam quia atque. 115003" }, "subtitle": { "en": " Beatae assumenda reiciendis. 115005", "fr": " Recusandae quam itaque. 115006" }, "short_description": { "en": "

Dolores soluta quia. 115008

", "fr": "

Soluta nihil asperiores. 115009

" }, "description": { "en": "

Accusamus et nemo. 115011

", "fr": "

Doloremque nisi tenetur. 115012

" }, "visibility": "public", "created_at": "2026-08-05T07:24:12Z", "updated_at": "2026-08-05T07:24:12Z" }, "relationships": { "components": { "data": [], "meta": { "count": 0 }, "links": { "self": { "href": "https://1231.lvh.me/api/rest_full/v0.3/public/components?filter[participatory_space_type_eq]=Decidim::ParticipatoryProcess&filter[participatory_space_id_eq]=1", "title": "Component list for this space", "rel": "resource", "meta": { "space_manifest": "participatory_processes", "space_id": "1", "action_method": "GET" } } } } }, "links": { "self": { "href": "https://1231.lvh.me/public/participatory_processes/1", "title": "en", "rel": "resource", "meta": { "space_id": "1", "space_manifest": "participatory_processes", "action_method": "GET" } }, "related": { "href": "https://1231.lvh.me/system/organizations/1974", "title": "Lesch-Lemke", "rel": "resource", "meta": { "action_method": "GET" } } } } ] } } }, "schema": { "$ref": "#/components/schemas/space_index_response" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } }, "401": { "description": "Unauthorized when no Bearer token", "content": { "application/json": { "examples": { "unauthorized": { "value": { "error": "401: Unauthorized access", "error_description": "Unauthorized access" } } }, "schema": { "$ref": "#/components/schemas/error_response" } } } } } } }, "/proposals/{id}": { "get": { "summary": "Proposal Details", "tags": [ "Proposals" ], "security": [ { "resourceOwnerFlowBearer": [ "proposals" ] } ], "operationId": "getProposal", "description": "Proposal detail", "parameters": [ { "name": "locales[]", "in": "query", "style": "form", "explode": true, "schema": { "type": "array", "title": "Available locales", "description": "List of locale codes the organization exposes.", "items": { "$ref": "#/components/schemas/locale" } }, "required": false }, { "name": "space_manifest", "in": "query", "schema": { "type": "string", "enum": [ "participatory_processes", "assemblies", "conferences", "initiatives" ], "description": "Space type" }, "required": false }, { "name": "space_id", "in": "query", "schema": { "type": "integer", "description": "Space Id" }, "required": false }, { "name": "component_id", "in": "query", "schema": { "type": "integer", "description": "Component Id" }, "required": false }, { "name": "filter[voted_weight_not_in][]", "in": "query", "style": "form", "explode": true, "schema": { "type": "array", "items": { "type": "string" }, "title": "voted_weight not IN filter", "description": "match none of _voted_weight_'s values in array" }, "required": false }, { "name": "filter[voted_weight_in][]", "in": "query", "style": "form", "explode": true, "schema": { "type": "array", "items": { "type": "string" }, "title": "voted_weight IN filter", "description": "match one of _voted_weight_'s values in array" }, "required": false }, { "name": "filter[voted_weight_start]", "in": "query", "schema": { "type": "string", "description": "_voted_weight_ starts with", "title": "voted_weight starts With filter", "example": "some_string" }, "required": false }, { "name": "filter[voted_weight_eq]", "in": "query", "schema": { "type": "string", "title": "voted_weight equal filter", "description": "_voted_weight_ is equal to" }, "required": false }, { "name": "filter[voted_weight_not_eq]", "in": "query", "schema": { "type": "string", "title": "voted_weight not equal filter", "description": "_voted_weight_ is NOT equal to" }, "required": false }, { "name": "filter[voted_weight_matches]", "in": "query", "schema": { "type": "string", "title": "voted_weight like filter", "description": "matches _voted_weight_ with `LIKE`", "example": "%some_string" }, "required": false }, { "name": "filter[voted_weight_blank]", "in": "query", "schema": { "type": "boolean", "title": "voted_weight blank filter", "description": "_voted_weight_ is null or empty" }, "required": false }, { "name": "filter[state_not_in][]", "in": "query", "style": "form", "explode": true, "schema": { "type": "array", "items": { "type": "string" }, "title": "state not IN filter", "description": "match none of _state_'s values in array" }, "required": false }, { "name": "filter[state_in][]", "in": "query", "style": "form", "explode": true, "schema": { "type": "array", "items": { "type": "string" }, "title": "state IN filter", "description": "match one of _state_'s values in array" }, "required": false }, { "name": "filter[state_start]", "in": "query", "schema": { "type": "string", "description": "_state_ starts with", "title": "state starts With filter", "example": "some_string" }, "required": false }, { "name": "filter[state_eq]", "in": "query", "schema": { "type": "string", "title": "state equal filter", "description": "_state_ is equal to" }, "required": false }, { "name": "filter[state_not_eq]", "in": "query", "schema": { "type": "string", "title": "state not equal filter", "description": "_state_ is NOT equal to" }, "required": false }, { "name": "filter[state_matches]", "in": "query", "schema": { "type": "string", "title": "state like filter", "description": "matches _state_ with `LIKE`", "example": "%some_string" }, "required": false }, { "name": "filter[state_blank]", "in": "query", "schema": { "type": "boolean", "title": "state blank filter", "description": "_state_ is null or empty" }, "required": false }, { "name": "order", "in": "query", "schema": { "type": "string" }, "description": "Order by", "required": false }, { "name": "order_direction", "in": "query", "schema": { "type": "string", "enum": [ "asc", "desc" ] }, "description": "Order direction", "required": false }, { "name": "id", "in": "path", "schema": { "type": "integer", "description": "Proposal Id" }, "required": true }, { "name": "Authorization", "in": "header", "schema": { "type": "string" }, "required": false, "description": "Bearer access token (see security schemes)" } ], "responses": { "404": { "description": "Not Found", "content": { "application/json": { "examples": { "not_found": { "value": { "error": "404: Resource not found", "error_description": "Resource not found" } } }, "schema": { "$ref": "#/components/schemas/error_response" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "examples": { "forbidden_impersonationFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } }, "forbidden_credentialFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } } }, "schema": { "$ref": "#/components/schemas/error_response" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } }, "200": { "description": "Proposal Found", "content": { "application/json": { "examples": { "ok_drafts": { "value": { "data": { "id": "5002", "type": "proposal", "attributes": { "created_at": "2026-08-05T07:26:42Z", "updated_at": "2026-08-05T07:26:42Z", "title": { "en": " Perspiciatis ad numquam. 126290", "fr": " Molestiae provident non. 126291" }, "body": { "en": "

Laboriosam aut rerum. 126293

", "fr": "

Qui incidunt sed. 126294

" } }, "relationships": { "space": { "data": { "id": "3105", "type": "participatory_processes" } }, "component": { "data": { "id": "9783", "type": "proposal_component" } }, "author": { "data": { "id": "6621", "type": "user" } }, "coauthors": { "data": [ { "id": "6621", "type": "user" } ], "meta": { "count": 1 } } }, "links": { "related": { "href": "https://1340.lvh.me/public/components/9783", "title": " Magni cum autem. 126268", "rel": "resource", "meta": { "space_id": "3105", "space_manifest": "participatory_processes", "component_id": "9783", "component_manifest": "proposals", "action_method": "GET" } }, "self": { "href": "https://1340.lvh.me/api/rest_full/v0.3/proposals/5002", "title": "Proposals Details", "rel": "resource", "meta": { "component_id": "9783", "component_manifest": "proposals", "space_id": "3105", "space_manifest": "participatory_processes", "resource_id": "5002", "action_method": "GET" } }, "collection": { "href": "https://1340.lvh.me/api/rest_full/v0.3/proposals", "title": "Proposals List", "rel": "resource", "meta": { "component_id": "9783", "component_manifest": "proposals", "space_id": "3105", "space_manifest": "participatory_processes", "resource_id": "5002", "action_method": "GET" } }, "prev": { "href": "https://1340.lvh.me/api/rest_full/v0.3/proposals/5001", "title": "Previous Proposal", "rel": "resource", "meta": { "component_id": "9783", "component_manifest": "proposals", "space_id": "3105", "space_manifest": "participatory_processes", "resource_id": "5001", "action_method": "GET" } } }, "meta": { "published": false } } } }, "ok": { "value": { "data": { "id": "5025", "type": "proposal", "attributes": { "created_at": "2026-08-05T07:26:52Z", "updated_at": "2026-08-05T07:26:52Z", "title": { "en": " Aliquid quas velit. 127122", "fr": " Quia consequatur minima. 127123" }, "body": { "en": "

Quo aut quis. 127125

", "fr": "

Distinctio quasi autem. 127126

" } }, "relationships": { "space": { "data": { "id": "3115", "type": "participatory_processes" } }, "component": { "data": { "id": "9795", "type": "proposal_component" } }, "author": { "data": { "id": "6651", "type": "user" } }, "coauthors": { "data": [ { "id": "6651", "type": "user" } ], "meta": { "count": 1 } } }, "links": { "related": { "href": "https://1350.lvh.me/public/components/9795", "title": " Est ab sed. 127113", "rel": "resource", "meta": { "space_id": "3115", "space_manifest": "participatory_processes", "component_id": "9795", "component_manifest": "proposals", "action_method": "GET" } }, "self": { "href": "https://1350.lvh.me/api/rest_full/v0.3/proposals/5025", "title": "Proposals Details", "rel": "resource", "meta": { "component_id": "9795", "component_manifest": "proposals", "space_id": "3115", "space_manifest": "participatory_processes", "resource_id": "5025", "action_method": "GET" } }, "collection": { "href": "https://1350.lvh.me/api/rest_full/v0.3/proposals", "title": "Proposals List", "rel": "resource", "meta": { "component_id": "9795", "component_manifest": "proposals", "space_id": "3115", "space_manifest": "participatory_processes", "resource_id": "5025", "action_method": "GET" } } }, "meta": { "published": true } } } }, "navigation_non_rejected": { "value": { "data": { "id": "5033", "type": "proposal", "attributes": { "created_at": "2026-08-05T07:26:54Z", "updated_at": "2026-08-05T07:26:54Z", "title": { "en": " Est atque repellendus. 127379", "fr": " Autem qui enim. 127380" }, "body": { "en": "

Aut aspernatur quia. 127382

", "fr": "

Adipisci exercitationem error. 127383

" } }, "relationships": { "space": { "data": { "id": "3118", "type": "participatory_processes" } }, "component": { "data": { "id": "9798", "type": "proposal_component" } }, "state": { "data": { "id": "6776", "type": "proposal_state" }, "meta": { "token": "accepted" } }, "author": { "data": { "id": "6659", "type": "user" } }, "coauthors": { "data": [ { "id": "6659", "type": "user" } ], "meta": { "count": 1 } } }, "links": { "related": { "href": "https://1353.lvh.me/public/components/9798", "title": " Maxime vero corporis. 127357", "rel": "resource", "meta": { "space_id": "3118", "space_manifest": "participatory_processes", "component_id": "9798", "component_manifest": "proposals", "action_method": "GET" } }, "self": { "href": "https://1353.lvh.me/api/rest_full/v0.3/proposals/5033", "title": "Proposals Details", "rel": "resource", "meta": { "component_id": "9798", "component_manifest": "proposals", "space_id": "3118", "space_manifest": "participatory_processes", "resource_id": "5033", "action_method": "GET" } }, "collection": { "href": "https://1353.lvh.me/api/rest_full/v0.3/proposals", "title": "Proposals List", "rel": "resource", "meta": { "component_id": "9798", "component_manifest": "proposals", "space_id": "3118", "space_manifest": "participatory_processes", "resource_id": "5033", "action_method": "GET" } }, "next": { "href": "https://1353.lvh.me/api/rest_full/v0.3/proposals/5035", "title": "Next Proposal", "rel": "resource", "meta": { "component_id": "9798", "component_manifest": "proposals", "space_id": "3118", "space_manifest": "participatory_processes", "resource_id": "5035", "action_method": "GET" } }, "prev": { "href": "https://1353.lvh.me/api/rest_full/v0.3/proposals/5032", "title": "Previous Proposal", "rel": "resource", "meta": { "component_id": "9798", "component_manifest": "proposals", "space_id": "3118", "space_manifest": "participatory_processes", "resource_id": "5032", "action_method": "GET" } } }, "meta": { "published": true } } } }, "navigation_last_accepted": { "value": { "data": { "id": "5030", "type": "proposal", "attributes": { "created_at": "2026-08-05T07:26:53Z", "updated_at": "2026-08-05T07:26:53Z", "title": { "en": " Autem nostrum culpa. 127289", "fr": " Aliquid nemo at. 127290" }, "body": { "en": "

Ipsa inventore sit. 127292

", "fr": "

Error optio ipsum. 127293

" } }, "relationships": { "space": { "data": { "id": "3117", "type": "participatory_processes" } }, "component": { "data": { "id": "9797", "type": "proposal_component" } }, "state": { "data": { "id": "6773", "type": "proposal_state" }, "meta": { "token": "accepted" } }, "author": { "data": { "id": "6656", "type": "user" } }, "coauthors": { "data": [ { "id": "6656", "type": "user" } ], "meta": { "count": 1 } } }, "links": { "related": { "href": "https://1352.lvh.me/public/components/9797", "title": " Tempore non itaque. 127254", "rel": "resource", "meta": { "space_id": "3117", "space_manifest": "participatory_processes", "component_id": "9797", "component_manifest": "proposals", "action_method": "GET" } }, "self": { "href": "https://1352.lvh.me/api/rest_full/v0.3/proposals/5030", "title": "Proposals Details", "rel": "resource", "meta": { "component_id": "9797", "component_manifest": "proposals", "space_id": "3117", "space_manifest": "participatory_processes", "resource_id": "5030", "action_method": "GET" } }, "collection": { "href": "https://1352.lvh.me/api/rest_full/v0.3/proposals", "title": "Proposals List", "rel": "resource", "meta": { "component_id": "9797", "component_manifest": "proposals", "space_id": "3117", "space_manifest": "participatory_processes", "resource_id": "5030", "action_method": "GET" } }, "prev": { "href": "https://1352.lvh.me/api/rest_full/v0.3/proposals/5029", "title": "Previous Proposal", "rel": "resource", "meta": { "component_id": "9797", "component_manifest": "proposals", "space_id": "3117", "space_manifest": "participatory_processes", "resource_id": "5029", "action_method": "GET" } } }, "meta": { "published": true } } } }, "accepted_proposal": { "value": { "data": { "id": "5027", "type": "proposal", "attributes": { "created_at": "2026-08-05T07:26:52Z", "updated_at": "2026-08-05T07:26:52Z", "title": { "en": " Fugit consequatur quia. 127199", "fr": " Nihil impedit ut. 127200" }, "body": { "en": "

Doloribus sequi voluptas. 127202

", "fr": "

Et maxime voluptate. 127203

" } }, "relationships": { "space": { "data": { "id": "3116", "type": "participatory_processes" } }, "component": { "data": { "id": "9796", "type": "proposal_component" } }, "state": { "data": { "id": "6770", "type": "proposal_state" }, "meta": { "token": "accepted" } }, "author": { "data": { "id": "6653", "type": "user" } }, "coauthors": { "data": [ { "id": "6653", "type": "user" } ], "meta": { "count": 1 } } }, "links": { "related": { "href": "https://1351.lvh.me/public/components/9796", "title": " Cupiditate atque in. 127177", "rel": "resource", "meta": { "space_id": "3116", "space_manifest": "participatory_processes", "component_id": "9796", "component_manifest": "proposals", "action_method": "GET" } }, "self": { "href": "https://1351.lvh.me/api/rest_full/v0.3/proposals/5027", "title": "Proposals Details", "rel": "resource", "meta": { "component_id": "9796", "component_manifest": "proposals", "space_id": "3116", "space_manifest": "participatory_processes", "resource_id": "5027", "action_method": "GET" } }, "collection": { "href": "https://1351.lvh.me/api/rest_full/v0.3/proposals", "title": "Proposals List", "rel": "resource", "meta": { "component_id": "9796", "component_manifest": "proposals", "space_id": "3116", "space_manifest": "participatory_processes", "resource_id": "5027", "action_method": "GET" } }, "prev": { "href": "https://1351.lvh.me/api/rest_full/v0.3/proposals/5026", "title": "Previous Proposal", "rel": "resource", "meta": { "component_id": "9796", "component_manifest": "proposals", "space_id": "3116", "space_manifest": "participatory_processes", "resource_id": "5026", "action_method": "GET" } } }, "meta": { "published": true } } } } }, "schema": { "$ref": "#/components/schemas/proposal_item_response" } } } } } } }, "/meetings/{id}/extended_data/sync": { "put": { "summary": "Set meeting extended data (sync)", "tags": [ "Meetings" ], "operationId": "setMeetingExtendedData", "description": "Merge meeting extended data at `object_path`. See [Extended data](https://octree-gva.github.io/decidim-rest-full/integrator/extended-data).\n", "parameters": [ { "name": "object_path", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "schema": { "type": "string" }, "required": true }, { "name": "Authorization", "in": "header", "schema": { "type": "string" }, "required": false, "description": "Bearer access token (see security schemes)" } ], "security": [ { "credentialFlowBearer": [ "meetings" ] } ], "responses": { "403": { "description": "Forbidden", "content": { "application/json": { "examples": { "forbidden_credentialFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } } }, "schema": { "$ref": "#/components/schemas/error_response" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } }, "200": { "description": "Updated", "content": { "application/json": { "examples": { "ok": { "value": { "data": { "hello": "world" } } } }, "schema": { "$ref": "#/components/schemas/resource_extended_data" } } } } }, "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "additionalProperties": true } }, "required": [ "data" ] } } }, "required": true } } }, "/meetings/{id}/extended_data": { "get": { "summary": "Meeting extended data", "tags": [ "Meetings" ], "operationId": "getMeetingExtendedData", "description": "Fetch meeting extended data at `object_path`. See [Extended data](https://octree-gva.github.io/decidim-rest-full/integrator/extended-data).\n", "parameters": [ { "name": "object_path", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "schema": { "type": "string" }, "required": true }, { "name": "Authorization", "in": "header", "schema": { "type": "string" }, "required": false, "description": "Bearer access token (see security schemes)" } ], "security": [ { "credentialFlowBearer": [ "meetings" ] } ], "responses": { "200": { "description": "Extended data", "content": { "application/json": { "examples": { "ok": { "value": { "data": { "foo": { "bar": "true" } } } } }, "schema": { "$ref": "#/components/schemas/resource_extended_data" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "examples": { "forbidden_credentialFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } } }, "schema": { "$ref": "#/components/schemas/error_response" } } } } } } }, "/me/magic_links": { "post": { "summary": "Create a magic link", "tags": [ "Users" ], "operationId": "generateMagicLink", "description": "Generates a uniq magic link, valid for 5minutes. If the user follow this link, it will be signed in automatically\n", "parameters": [ { "name": "Authorization", "in": "header", "schema": { "type": "string" }, "required": false, "description": "Bearer access token (see security schemes)" } ], "security": [ { "resourceOwnerFlowBearer": [ "oauth" ] } ], "responses": { "422": { "description": "Validation error", "content": { "application/json": { "examples": { "bad_redirect_host": { "value": { "errors": [ { "attribute": "redirect_url", "message": "Host is not allowed for this organization" } ] } }, "bad_redirect_http": { "value": { "errors": [ { "attribute": "redirect_url", "message": "Must use the https scheme" } ] } } }, "schema": { "type": "object", "properties": { "errors": { "type": "array", "items": { "type": "object", "properties": { "attribute": { "type": "string" }, "message": { "type": "string" } } } } }, "required": [ "errors" ] } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "examples": { "bad_blocked": { "value": { "error": "400: Bad request", "error_description": "User blocked" } } }, "schema": { "$ref": "#/components/schemas/error_response" } } } }, "201": { "description": "Magick link created", "content": { "application/json": { "examples": { "ok_with_redirect": { "value": { "data": { "id": "13", "type": "magic_link", "attributes": { "token": "dm1HWnJEZlJ0RGNxa0RwM0tUdjQ=", "label": "My label", "redirect_url": "https://www.partner.example/callback?x=1" }, "links": { "self": { "href": "https://1384.lvh.me/api/rest_full/v0.3/me/magic_links", "title": "Generates a magic link", "rel": "resource", "meta": { "action_method": "POST", "action_enctype": "application/x-www-form-urlencoded" } }, "sign_in": { "href": "https://1384.lvh.me/api/rest_full/v0.3/me/magic_links/dm1HWnJEZlJ0RGNxa0RwM0tUdjQ=", "title": "Sign in with magic link", "rel": "resource", "meta": { "action_method": "GET" } } } } } }, "ok": { "value": { "data": { "id": "14", "type": "magic_link", "attributes": { "token": "eHlCemt6eHhwbnJFVDRVb0pfeHo=", "label": "My label", "redirect_url": null }, "links": { "self": { "href": "https://1385.lvh.me/api/rest_full/v0.3/me/magic_links", "title": "Generates a magic link", "rel": "resource", "meta": { "action_method": "POST", "action_enctype": "application/x-www-form-urlencoded" } }, "sign_in": { "href": "https://1385.lvh.me/api/rest_full/v0.3/me/magic_links/eHlCemt6eHhwbnJFVDRVb0pfeHo=", "title": "Sign in with magic link", "rel": "resource", "meta": { "action_method": "GET" } } } } } } }, "schema": { "$ref": "#/components/schemas/magic_link_item_response" } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "examples": { "forbidden_impersonationFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } } }, "schema": { "$ref": "#/components/schemas/error_response" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } } }, "requestBody": { "content": { "application/json": { "schema": { "title": "Generate Magic Link Payload", "type": "object", "properties": { "data": { "title": "Generate Magic Link Data", "type": "object", "properties": { "redirect_url": { "type": "string", "description": "Optional HTTPS redirect URL after sign-in (host must be allowlisted)" } }, "description": "Optional payload to configure the magic link" } } } } } } } }, "/spaces/conferences/{id}": { "get": { "summary": "Conferences Details", "tags": [ "Spaces" ], "operationId": "showConference", "description": "Get detail of a Conferences given its id", "parameters": [ { "name": "locales[]", "in": "query", "style": "form", "explode": true, "schema": { "type": "array", "title": "Available locales", "description": "List of locale codes the organization exposes.", "items": { "$ref": "#/components/schemas/locale" } }, "required": false }, { "name": "id", "in": "path", "schema": { "type": "integer", "description": "Id of the space" }, "required": true }, { "name": "Authorization", "in": "header", "schema": { "type": "string" }, "required": false, "description": "Bearer access token (see security schemes)" } ], "security": [ { "resourceOwnerFlowBearer": [ "public" ] } ], "responses": { "403": { "description": "Forbidden", "content": { "application/json": { "examples": { "forbidden_impersonationFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } }, "forbidden_credentialFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } } }, "schema": { "$ref": "#/components/schemas/error_response" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } }, "200": { "description": "Conferences Details", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/space_item_response" }, "examples": { "ok": { "value": { "data": { "id": "78", "type": "space", "attributes": { "manifest_name": "conferences", "participatory_space_type": "Decidim::Conference", "title": { "en": "My conference for testing" }, "subtitle": {}, "short_description": { "en": "

Laudantium sunt quibusdam. 136223

", "fr": "

Id vitae nostrum. 136224

" }, "description": { "en": "

Ad nihil harum. 136226

", "fr": "

Magnam unde non. 136227

" }, "visibility": "public", "created_at": "2026-08-05T07:28:47Z", "updated_at": "2026-08-05T07:28:47Z" }, "relationships": { "components": { "data": [], "meta": { "count": 0 }, "links": { "self": { "href": "https://1444.lvh.me/api/rest_full/v0.3/public/components?filter[participatory_space_type_eq]=Decidim::Conference&filter[participatory_space_id_eq]=78", "title": "Component list for this space", "rel": "resource", "meta": { "space_manifest": "conferences", "space_id": "78", "action_method": "GET" } } } } }, "links": { "self": { "href": "https://1444.lvh.me/public/conferences/78", "title": "My conference for testing", "rel": "resource", "meta": { "space_id": "78", "space_manifest": "conferences", "action_method": "GET" } }, "related": { "href": "https://1444.lvh.me/system/organizations/2081", "title": "Jaskolski, Kerluke and Goyette", "rel": "resource", "meta": { "action_method": "GET" } } } } } } } } } }, "404": { "description": "Not found", "content": { "application/json": { "examples": { "not_found": { "value": { "error": "404: Record not found", "error_description": "Record not found" } } }, "schema": { "$ref": "#/components/schemas/error_response" } } } } } } }, "/spaces/participatory_processes/{id}": { "get": { "summary": "Participatory Processes Details", "tags": [ "Spaces" ], "operationId": "showParticipatoryProcess", "description": "Get detail of a Participatory Processes given its id", "parameters": [ { "name": "locales[]", "in": "query", "style": "form", "explode": true, "schema": { "type": "array", "title": "Available locales", "description": "List of locale codes the organization exposes.", "items": { "$ref": "#/components/schemas/locale" } }, "required": false }, { "name": "id", "in": "path", "schema": { "type": "integer", "description": "Id of the space" }, "required": true }, { "name": "Authorization", "in": "header", "schema": { "type": "string" }, "required": false, "description": "Bearer access token (see security schemes)" } ], "security": [ { "resourceOwnerFlowBearer": [ "public" ] } ], "responses": { "200": { "description": "Participatory Processes Details", "content": { "application/json": { "examples": { "ok": { "value": { "data": { "id": "3213", "type": "space", "attributes": { "manifest_name": "participatory_processes", "participatory_space_type": "Decidim::ParticipatoryProcess", "title": { "en": "My participatory_process for testing purpose", "fr": "c'est une concertation" }, "subtitle": { "en": " Eveniet dolorem eum. 148556", "fr": " Eveniet aperiam ut. 148557" }, "short_description": { "en": "

Aperiam et voluptatem. 148559

", "fr": "

At est quaerat. 148560

" }, "description": { "en": "

Aliquam ea sequi. 148562

", "fr": "

Itaque perferendis et. 148563

" }, "visibility": "public", "created_at": "2026-08-05T07:30:13Z", "updated_at": "2026-08-05T07:30:13Z" }, "relationships": { "components": { "data": [], "meta": { "count": 0 }, "links": { "self": { "href": "https://1535.lvh.me/api/rest_full/v0.3/public/components?filter[participatory_space_type_eq]=Decidim::ParticipatoryProcess&filter[participatory_space_id_eq]=3213", "title": "Component list for this space", "rel": "resource", "meta": { "space_manifest": "participatory_processes", "space_id": "3213", "action_method": "GET" } } } } }, "links": { "self": { "href": "https://1535.lvh.me/public/participatory_processes/3213", "title": "My participatory_process for testing purpose", "rel": "resource", "meta": { "space_id": "3213", "space_manifest": "participatory_processes", "action_method": "GET" } }, "related": { "href": "https://1535.lvh.me/system/organizations/2094", "title": "Bins, Hirthe and Gutkowski", "rel": "resource", "meta": { "action_method": "GET" } } } } } } }, "schema": { "$ref": "#/components/schemas/space_item_response" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } }, "404": { "description": "Not found", "content": { "application/json": { "examples": { "not_found": { "value": { "error": "404: Record not found", "error_description": "Record not found" } } }, "schema": { "$ref": "#/components/schemas/error_response" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "examples": { "forbidden_credentialFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } }, "forbidden_impersonationFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } } }, "schema": { "$ref": "#/components/schemas/error_response" } } } } } } }, "/spaces/initiatives/{id}": { "get": { "summary": "Initiatives Details", "tags": [ "Spaces" ], "operationId": "showInitiative", "description": "Get detail of a Initiatives given its id", "parameters": [ { "name": "locales[]", "in": "query", "style": "form", "explode": true, "schema": { "type": "array", "title": "Available locales", "description": "List of locale codes the organization exposes.", "items": { "$ref": "#/components/schemas/locale" } }, "required": false }, { "name": "id", "in": "path", "schema": { "type": "integer", "description": "Id of the space" }, "required": true }, { "name": "Authorization", "in": "header", "schema": { "type": "string" }, "required": false, "description": "Bearer access token (see security schemes)" } ], "security": [ { "resourceOwnerFlowBearer": [ "public" ] } ], "responses": { "200": { "description": "Initiatives Details", "content": { "application/json": { "examples": { "ok": { "value": { "data": { "id": "74", "type": "space", "attributes": { "manifest_name": "initiatives", "participatory_space_type": "Decidim::Initiative", "title": { "en": "My initiative for testing" }, "subtitle": {}, "short_description": {}, "description": { "en": "

Est rerum perspiciatis. 162943

", "fr": "

Quia ut cupiditate. 162944

" }, "visibility": "public", "created_at": "2026-08-05T07:32:24Z", "updated_at": "2026-08-05T07:32:24Z" }, "relationships": { "components": { "data": [], "meta": { "count": 0 }, "links": { "self": { "href": "https://1640.lvh.me/api/rest_full/v0.3/public/components?filter[participatory_space_type_eq]=Decidim::Initiative&filter[participatory_space_id_eq]=74", "title": "Component list for this space", "rel": "resource", "meta": { "space_manifest": "initiatives", "space_id": "74", "action_method": "GET" } } } } }, "links": { "self": { "href": "https://1640.lvh.me/public/initiatives/74", "title": "My initiative for testing", "rel": "resource", "meta": { "space_id": "74", "space_manifest": "initiatives", "action_method": "GET" } }, "related": { "href": "https://1640.lvh.me/system/organizations/2109", "title": "Russel-Macejkovic", "rel": "resource", "meta": { "action_method": "GET" } } } } } } }, "schema": { "$ref": "#/components/schemas/space_item_response" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "examples": { "forbidden_credentialFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } }, "forbidden_impersonationFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } } }, "schema": { "$ref": "#/components/schemas/error_response" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } }, "404": { "description": "Not found", "content": { "application/json": { "examples": { "not_found": { "value": { "error": "404: Record not found", "error_description": "Record not found" } } }, "schema": { "$ref": "#/components/schemas/error_response" } } } } } } }, "/spaces/assemblies/{id}": { "get": { "summary": "Assemblies Details", "tags": [ "Spaces" ], "operationId": "showAssembly", "description": "Get detail of a Assemblies given its id", "parameters": [ { "name": "locales[]", "in": "query", "style": "form", "explode": true, "schema": { "type": "array", "title": "Available locales", "description": "List of locale codes the organization exposes.", "items": { "$ref": "#/components/schemas/locale" } }, "required": false }, { "name": "id", "in": "path", "schema": { "type": "integer", "description": "Id of the space" }, "required": true }, { "name": "Authorization", "in": "header", "schema": { "type": "string" }, "required": false, "description": "Bearer access token (see security schemes)" } ], "security": [ { "resourceOwnerFlowBearer": [ "public" ] } ], "responses": { "404": { "description": "Not found", "content": { "application/json": { "examples": { "not_found": { "value": { "error": "404: Record not found", "error_description": "Record not found" } } }, "schema": { "$ref": "#/components/schemas/error_response" } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "examples": { "forbidden_credentialFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } }, "forbidden_impersonationFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } } }, "schema": { "$ref": "#/components/schemas/error_response" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } }, "200": { "description": "Assemblies Details", "content": { "application/json": { "examples": { "ok": { "value": { "data": { "id": "2517", "type": "space", "attributes": { "manifest_name": "assemblies", "participatory_space_type": "Decidim::Assembly", "title": { "en": "My assembly for testing purpose", "fr": "c'est une assemblée" }, "subtitle": { "en": " Consequatur facere ad. 172254", "fr": " Inventore odit ad. 172255" }, "short_description": { "en": "

Exercitationem vero accusantium. 172257

", "fr": "

Aut sit est. 172258

" }, "description": { "en": "

Id harum officia. 172260

", "fr": "

Consequuntur doloremque quis. 172261

" }, "visibility": "transparent", "created_at": "2026-08-05T07:33:49Z", "updated_at": "2026-08-05T07:33:49Z" }, "relationships": { "components": { "data": [ { "id": "10546", "type": "page_component" }, { "id": "10547", "type": "proposal_component" }, { "id": "10548", "type": "meeting_component" }, { "id": "10549", "type": "budget_component" }, { "id": "10550", "type": "survey_component" }, { "id": "10551", "type": "accountability_component" }, { "id": "10552", "type": "debate_component" }, { "id": "10553", "type": "blog_component" }, { "id": "10554", "type": "awesome_map_component" }, { "id": "10555", "type": "awesome_iframe_component" }, { "id": "10556", "type": "proposal_component" }, { "id": "10557", "type": "meeting_component" }, { "id": "10558", "type": "proposal_component" }, { "id": "10559", "type": "meeting_component" }, { "id": "10560", "type": "proposal_component" }, { "id": "10561", "type": "meeting_component" } ], "meta": { "count": 16 }, "links": { "self": { "href": "https://1710.lvh.me/api/rest_full/v0.3/public/components?filter[participatory_space_type_eq]=Decidim::Assembly&filter[participatory_space_id_eq]=2517", "title": "Component list for this space", "rel": "resource", "meta": { "space_manifest": "assemblies", "space_id": "2517", "action_method": "GET" } } } } }, "links": { "self": { "href": "https://1710.lvh.me/public/assemblies/2517", "title": "My assembly for testing purpose", "rel": "resource", "meta": { "space_id": "2517", "space_manifest": "assemblies", "action_method": "GET" } }, "related": { "href": "https://1710.lvh.me/system/organizations/2119", "title": "Murray, Cremin and Murazik", "rel": "resource", "meta": { "action_method": "GET" } } } } } } }, "schema": { "$ref": "#/components/schemas/space_item_response" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } } } } }, "/proposals/{id}/extended_data/sync": { "put": { "summary": "Set proposal extended data (sync)", "tags": [ "Proposals" ], "operationId": "setProposalExtendedData", "description": "See [Extended data](https://octree-gva.github.io/decidim-rest-full/integrator/extended-data).", "parameters": [ { "name": "object_path", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "schema": { "type": "string" }, "required": true }, { "name": "Authorization", "in": "header", "schema": { "type": "string" }, "required": false, "description": "Bearer access token (see security schemes)" } ], "security": [ { "credentialFlowBearer": [ "proposals" ] } ], "responses": { "200": { "description": "Updated", "content": { "application/json": { "examples": { "ok": { "value": { "data": { "source": "sync" } } } }, "schema": { "$ref": "#/components/schemas/resource_extended_data" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "examples": { "forbidden_credentialFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } } }, "schema": { "$ref": "#/components/schemas/error_response" } } } } }, "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "additionalProperties": true } }, "required": [ "data" ] } } }, "required": true } } }, "/proposals/{id}/extended_data": { "get": { "summary": "Proposal extended data", "tags": [ "Proposals" ], "operationId": "getProposalExtendedData", "description": "See [Extended data](https://octree-gva.github.io/decidim-rest-full/integrator/extended-data).", "parameters": [ { "name": "object_path", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "schema": { "type": "string" }, "required": true }, { "name": "Authorization", "in": "header", "schema": { "type": "string" }, "required": false, "description": "Bearer access token (see security schemes)" } ], "security": [ { "credentialFlowBearer": [ "proposals" ] } ], "responses": { "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" }, "examples": { "forbidden_credentialFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } }, "200": { "description": "Extended data", "content": { "application/json": { "examples": { "ok": { "value": { "data": { "source": "api" } } } }, "schema": { "$ref": "#/components/schemas/resource_extended_data" } } } } } } }, "/components/blog_components": { "get": { "summary": "Blog Components", "tags": [ "Components" ], "operationId": "listBlogComponents", "description": "List or search blog components of the organization", "parameters": [ { "name": "page", "in": "query", "description": "Page number for pagination", "required": false, "schema": { "type": "integer" } }, { "name": "per_page", "in": "query", "description": "Number of items per page", "required": false, "schema": { "type": "integer" } }, { "name": "locales[]", "in": "query", "style": "form", "explode": true, "schema": { "type": "array", "title": "Available locales", "description": "List of locale codes the organization exposes.", "items": { "$ref": "#/components/schemas/locale" } }, "required": false }, { "name": "filter[participatory_space_id_in][]", "in": "query", "style": "form", "explode": true, "schema": { "type": "array", "items": { "type": "string" }, "title": "participatory_space_id IN filter", "description": "match one of _participatory_space_id_'s values in array" }, "required": false }, { "name": "filter[participatory_space_id_eq]", "in": "query", "schema": { "type": "string", "title": "participatory_space_id equal filter", "description": "_participatory_space_id_ is equal to" }, "required": false }, { "name": "filter[participatory_space_id_lt]", "in": "query", "schema": { "type": "string", "title": "participatory_space_id less than filter", "description": "_participatory_space_id_ is less than" }, "required": false }, { "name": "filter[participatory_space_id_gt]", "in": "query", "schema": { "type": "string", "title": "participatory_space_id greater than filter", "description": "_participatory_space_id_ is greater than" }, "required": false }, { "name": "filter[participatory_space_id_present]", "in": "query", "schema": { "type": "boolean", "title": "participatory_space_id present filter", "description": "_participatory_space_id_ is not null and not empty" }, "required": false }, { "name": "filter[participatory_space_id_blank]", "in": "query", "schema": { "type": "boolean", "title": "participatory_space_id blank filter", "description": "_participatory_space_id_ is null or empty" }, "required": false }, { "name": "filter[participatory_space_type_not_in][]", "in": "query", "style": "form", "explode": true, "schema": { "type": "array", "items": { "type": "string", "example": "Decidim::Assembly" }, "title": "participatory_space_type not IN filter", "description": "match none of _participatory_space_type_'s values in array" }, "required": false }, { "name": "filter[participatory_space_type_in][]", "in": "query", "style": "form", "explode": true, "schema": { "type": "array", "items": { "type": "string", "example": "Decidim::Assembly" }, "title": "participatory_space_type IN filter", "description": "match one of _participatory_space_type_'s values in array" }, "required": false }, { "name": "filter[participatory_space_type_start]", "in": "query", "schema": { "type": "string", "description": "_participatory_space_type_ starts with", "title": "participatory_space_type starts With filter", "example": "some_string" }, "required": false }, { "name": "filter[participatory_space_type_eq]", "in": "query", "schema": { "type": "string", "example": "Decidim::Assembly", "title": "participatory_space_type equal filter", "description": "_participatory_space_type_ is equal to" }, "required": false }, { "name": "filter[participatory_space_type_not_eq]", "in": "query", "schema": { "type": "string", "example": "Decidim::Assembly", "title": "participatory_space_type not equal filter", "description": "_participatory_space_type_ is NOT equal to" }, "required": false }, { "name": "filter[participatory_space_type_matches]", "in": "query", "schema": { "type": "string", "title": "participatory_space_type like filter", "description": "matches _participatory_space_type_ with `LIKE`", "example": "%some_string" }, "required": false }, { "name": "filter[participatory_space_type_blank]", "in": "query", "schema": { "type": "boolean", "title": "participatory_space_type blank filter", "description": "_participatory_space_type_ is null or empty" }, "required": false }, { "name": "filter[name_not_in][]", "in": "query", "style": "form", "explode": true, "schema": { "type": "array", "items": { "type": "string" }, "title": "name not IN filter", "description": "match none of _name_'s values in array" }, "required": false }, { "name": "filter[name_in][]", "in": "query", "style": "form", "explode": true, "schema": { "type": "array", "items": { "type": "string" }, "title": "name IN filter", "description": "match one of _name_'s values in array" }, "required": false }, { "name": "filter[name_start]", "in": "query", "schema": { "type": "string", "description": "_name_ starts with", "title": "name starts With filter", "example": "some_string" }, "required": false }, { "name": "filter[name_eq]", "in": "query", "schema": { "type": "string", "title": "name equal filter", "description": "_name_ is equal to" }, "required": false }, { "name": "filter[name_not_eq]", "in": "query", "schema": { "type": "string", "title": "name not equal filter", "description": "_name_ is NOT equal to" }, "required": false }, { "name": "filter[name_matches]", "in": "query", "schema": { "type": "string", "title": "name like filter", "description": "matches _name_ with `LIKE`", "example": "%some_string" }, "required": false }, { "name": "filter[name_blank]", "in": "query", "schema": { "type": "boolean", "title": "name blank filter", "description": "_name_ is null or empty" }, "required": false }, { "name": "Authorization", "in": "header", "schema": { "type": "string" }, "required": false, "description": "Bearer access token (see security schemes)" } ], "security": [ { "credentialFlowBearer": [ "public" ] } ], "responses": { "403": { "description": "Forbidden", "content": { "application/json": { "examples": { "forbidden_credentialFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } }, "forbidden_impersonationFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } } }, "schema": { "$ref": "#/components/schemas/error_response" } } } }, "200": { "description": "List of blog components", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/blog_component_index_response" }, "examples": { "paginated": { "value": { "data": [ { "id": "10648", "type": "blog_component", "attributes": { "manifest_name": "blogs", "participatory_space_type": "Decidim::ParticipatoryProcess", "participatory_space_id": "3350", "name": { "en": " Rerum possimus harum. 178007", "fr": " Et et quaerat. 178008" }, "global_announcement": {}, "created_at": "2026-08-05T07:35:27Z", "updated_at": "2026-08-05T07:35:27Z" }, "relationships": { "resources": { "data": [], "meta": { "count": 0 } } }, "links": { "self": { "href": "https://1756.lvh.me/components/blog_components/10648", "title": " Rerum possimus harum. 178007", "rel": "resource", "meta": { "space_id": "3350", "space_manifest": "participatory_processes", "action_method": "GET" } }, "related": { "href": "https://1756.lvh.me/spaces/participatory_processes/3350", "title": " Officiis sunt harum. 177930", "rel": "resource", "meta": { "space_id": "3350", "space_manifest": "participatory_processes", "action_method": "GET" } } }, "meta": { "published": true, "scopes_enabled": false } }, { "id": "10649", "type": "blog_component", "attributes": { "manifest_name": "blogs", "participatory_space_type": "Decidim::ParticipatoryProcess", "participatory_space_id": "3350", "name": { "en": " Similique qui amet. 178016", "fr": " Sunt sunt iure. 178017" }, "global_announcement": {}, "created_at": "2026-08-05T07:35:27Z", "updated_at": "2026-08-05T07:35:27Z" }, "relationships": { "resources": { "data": [], "meta": { "count": 0 } } }, "links": { "self": { "href": "https://1756.lvh.me/components/blog_components/10649", "title": " Similique qui amet. 178016", "rel": "resource", "meta": { "space_id": "3350", "space_manifest": "participatory_processes", "action_method": "GET" } }, "related": { "href": "https://1756.lvh.me/spaces/participatory_processes/3350", "title": " Officiis sunt harum. 177930", "rel": "resource", "meta": { "space_id": "3350", "space_manifest": "participatory_processes", "action_method": "GET" } } }, "meta": { "published": true, "scopes_enabled": false } } ] } }, "components_in_Process": { "value": { "data": [ { "id": "10638", "type": "blog_component", "attributes": { "manifest_name": "blogs", "participatory_space_type": "Decidim::ParticipatoryProcess", "participatory_space_id": "3347", "name": { "en": " Veniam expedita harum. 177569", "fr": " Doloribus excepturi corrupti. 177570" }, "global_announcement": {}, "created_at": "2026-08-05T07:35:22Z", "updated_at": "2026-08-05T07:35:22Z" }, "relationships": { "resources": { "data": [], "meta": { "count": 0 } } }, "links": { "self": { "href": "https://1753.lvh.me/components/blog_components/10638", "title": " Veniam expedita harum. 177569", "rel": "resource", "meta": { "space_id": "3347", "space_manifest": "participatory_processes", "action_method": "GET" } }, "related": { "href": "https://1753.lvh.me/spaces/participatory_processes/3347", "title": " Officia sequi quia. 177498", "rel": "resource", "meta": { "space_id": "3347", "space_manifest": "participatory_processes", "action_method": "GET" } } }, "meta": { "published": true, "scopes_enabled": false } } ] } }, "ok": { "value": { "data": [ { "id": "10636", "type": "blog_component", "attributes": { "manifest_name": "blogs", "participatory_space_type": "Decidim::ParticipatoryProcess", "participatory_space_id": "3346", "name": { "en": " Ut occaecati id. 177434", "fr": " Quod sed necessitatibus. 177435" }, "global_announcement": {}, "created_at": "2026-08-05T07:35:21Z", "updated_at": "2026-08-05T07:35:21Z" }, "relationships": { "resources": { "data": [], "meta": { "count": 0 } } }, "links": { "self": { "href": "https://1752.lvh.me/components/blog_components/10636", "title": " Ut occaecati id. 177434", "rel": "resource", "meta": { "space_id": "3346", "space_manifest": "participatory_processes", "action_method": "GET" } }, "related": { "href": "https://1752.lvh.me/spaces/participatory_processes/3346", "title": " Sed sit ut. 177363", "rel": "resource", "meta": { "space_id": "3346", "space_manifest": "participatory_processes", "action_method": "GET" } } }, "meta": { "published": true, "scopes_enabled": false } } ] } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } } } } }, "/components/blog_components/{id}": { "get": { "summary": "Blog Component Details", "tags": [ "Components" ], "operationId": "showBlogComponent", "description": "Blog component details", "parameters": [ { "name": "locales[]", "in": "query", "style": "form", "explode": true, "schema": { "type": "array", "title": "Available locales", "description": "List of locale codes the organization exposes.", "items": { "$ref": "#/components/schemas/locale" } }, "required": false }, { "name": "id", "in": "path", "schema": { "type": "integer" }, "required": true }, { "name": "component_id", "in": "query", "schema": { "type": "integer", "description": "Component Id" }, "required": false }, { "name": "space_manifest", "in": "query", "schema": { "type": "string", "enum": [ "participatory_processes", "assemblies", "conferences", "initiatives" ], "description": "Space type" }, "required": false }, { "name": "space_id", "in": "query", "schema": { "type": "integer", "description": "Space Id" }, "required": false }, { "name": "Authorization", "in": "header", "schema": { "type": "string" }, "required": false, "description": "Bearer access token (see security schemes)" } ], "security": [ { "credentialFlowBearer": [ "public" ] } ], "responses": { "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" }, "examples": { "forbidden_impersonationFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } }, "forbidden_credentialFlow": { "value": { "error": "403: Forbidden", "error_description": "Forbidden" } } } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error_response" } } } }, "200": { "description": "Blog Component", "content": { "application/json": { "examples": { "ok": { "value": { "data": { "id": "10679", "type": "blog_component", "attributes": { "manifest_name": "blogs", "participatory_space_type": "Decidim::ParticipatoryProcess", "participatory_space_id": "3372", "name": { "en": " Est tempora sunt. 180058", "fr": " Voluptas ducimus vel. 180059" }, "global_announcement": {}, "created_at": "2026-08-05T07:36:19Z", "updated_at": "2026-08-05T07:36:19Z" }, "relationships": { "resources": { "data": [], "meta": { "count": 0 } } }, "links": { "self": { "href": "https://1777.lvh.me/components/blog_components/10679", "title": " Est tempora sunt. 180058", "rel": "resource", "meta": { "space_id": "3372", "space_manifest": "participatory_processes", "action_method": "GET" } }, "related": { "href": "https://1777.lvh.me/spaces/participatory_processes/3372", "title": " Rerum consequatur incidunt. 180073", "rel": "resource", "meta": { "space_id": "3372", "space_manifest": "participatory_processes", "action_method": "GET" } } }, "meta": { "published": true, "scopes_enabled": false } } } } }, "schema": { "$ref": "#/components/schemas/blog_component_item_response" } } } } } } } } }