Reference · VOR API 2.5.43

Every operation

84 operations on 72 endpoints, read from the live specification. Base address: https://your-domain.com. Parameters, request bodies and responses are in openapi.json.

Content and revisions

Create drafts, write language versions as immutable revisions, check before publishing, comment and compare.

GET/studio/api/kandisLook up a person in the site's celebrity data – quick facts for interviews
GET/studio/api/innehallThe content list – filter by section and status, or find stale and missing translations
POST/studio/api/innehallCreate content (a draft). Idempotent with Idempotency-Key.
GET/studio/api/innehall/{id}The content with all language versions and working revisions
PATCH/studio/api/innehall/{id}Change section, template, tags, categories, sponsorship, sources, owner, headline, status or deletion
PUT/studio/api/innehall/{id}/sprak/{sprak}Submit a language version – a new, immutable revision. 409 on conflict.
POST/studio/api/innehall/{id}/sprak/{sprak}/statusSet a language's status: draft, review, approved or needs update
GET/studio/api/innehall/{id}/sprak/{sprak}/revisionerThe revision history
POST/studio/api/innehall/{id}/sprak/{sprak}/aterstallRestore an earlier revision (it becomes a new revision)
GET/studio/api/svep/faktarutaRead-only sweep: published articles whose fact box is empty. Nothing is changed.
POST/studio/api/innehall/{id}/forslagSuggestions to choose from: SEO analysis and titles, tags and categories, related reading, hero alt text, promo texts
POST/studio/api/innehall/{id}/kopieraCopy to a new draft (same section, template, tags and categories)
POST/studio/api/innehall/{id}/valideraThe check before publishing: blocking errors and advisory warnings per language
GET/studio/api/dubbletterThe duplicate check: rows that share a WordPress ID or an address
GET/studio/api/innehall/{id}/revision/{rid}One revision in any language – for block-by-block comparison
GET/studio/api/innehall/{id}/kommentarerInternal comments
POST/studio/api/innehall/{id}/kommentarerA new internal comment to the editors
PATCH/studio/api/innehall/{id}/kommentarer/{kid}Mark a comment resolved or unresolved
POST/studio/api/innehall/{id}/lasA soft edit lock per language for 90 seconds – revisions handle real conflicts
GET/studio/api/innehall/{id}/loggThe content's log – who did what and when, releases included

Preview and publishing

Preview with the site's own rendering, share time-limited links, publish now or on a schedule, and follow every release.

GET/studio/live/{id}.jsonA live report's posts as JSON – public and sign-in free, published content only, cached for 20 seconds
POST/studio/api/innehall/{id}/nedtagningTake down a published article (editors only – agents get 403)
POST/studio/api/innehall/{id}/forhandsvisningPreview with the site's own rendering; dela=minutes gives a time-limited, revocable link
POST/studio/api/innehall/{id}/releasePublishing release: fixed revisions for chosen languages – draft, publish now or scheduled, in the publisher’s time zone
GET/studio/api/release/{id}A release's status and result
POST/studio/api/release/{id}/avbrytCancel a scheduled release
GET/studio/api/releaserThe calendar: releases within a time span
GET/studio/api/utkastWaiting for your yes: drafts written outside Studio, and Studio content in review
POST/studio/api/utkast/{id}/publiceraPublish now or schedule a draft VOR wrote – needs publishing rights
POST/studio/api/utkast/{id}/avfardaDismiss a draft (nothing is deleted in WordPress) – needs publishing rights
POST/studio/api/utkast/{id}/forhandsvisningPreview in Swedish and English in the site's own template
GET/studio/api/innehall/{id}/releaserThe content's releases
GET/studio/api/innehall/{id}/delningarShared previews
DELETE/studio/api/innehall/{id}/delningar/{token}Revoke a shared preview
POST/studio/api/release/{id}/korRun a scheduled or failed release now (publishers)

Translation and jobs

AI translation as drafts – one article or sixty at a time – with job status to poll.

POST/studio/api/innehall/{id}/oversattCreate a translation draft with the AI adapter (a job). For a manual translation, PUT the language version.
POST/studio/api/oversatt-listaRetranslate up to 60 articles in one sweep – one job per article, saved as drafts, nothing published
GET/studio/api/oversatt-listaStatus of the translation jobs – poll every 5–10 seconds until done
GET/studio/api/jobb/{id}Job status (translation and more)
GET/studio/api/jobbThe job list (latest 100)

Media library

Upload images, keep credits and rights, write alt text per language and see where each image is used.

GET/studio/api/mediaThe media library (search, page)
POST/studio/api/mediaUpload an image – by https address or as raw bytes (JPEG, PNG, WebP or GIF up to 40 MB) with credit and rights
GET/studio/api/media/wpSearch the WordPress media library for images already on the site
POST/studio/api/media/wpRegister a WordPress image in Studio – no new upload
GET/studio/api/media/{id}A media item with its texts
PATCH/studio/api/media/{id}Rights: photographer, source, credit, licence type, valid until, restrictions, reviewed
PUT/studio/api/media/{id}/text/{sprak}Alt text and caption per language (and per use)
GET/studio/api/media/{id}/anvandningWhere the image is used
PUT/studio/api/media/{id}/filReplace an image's file but keep its address – everything pointing to it shows the new image

Tags, categories and people

Suggest and set tags, create tags for names and read the site's dictionary of people.

GET/studio/api/taggarTags: status, the hundred largest tags, articles without a tag
GET/studio/api/kategorierCategories from WordPress
POST/studio/api/taggar/forslagSuggest up to four tags for an article from the existing tags
POST/studio/api/taggar/sattSet tags on an article and update the search index – needs publishing rights
GET/studio/api/ordbokDictionary and people: the most written-about people, names without a tag, the commonest words
POST/studio/api/ordbok/taggCreate a tag for a name that has none – needs publishing rights

Assignments and ideas

The shared queue between editors and agents, and the ideas from media monitoring.

GET/studio/api/uppdragThe assignment queue: awaiting review, open, done and dismissed
POST/studio/api/uppdragA new assignment for VOR {text, section, priority}
POST/studio/api/uppdrag/{id}/{atgard}Approve, send back or dismiss an assignment – needs publishing rights
GET/studio/api/forslagvyIdeas: business opportunities, editorial angles, Google Trends, orders, campaigns to pick from, sources
POST/studio/api/forslag/{id}/bestallOrder an idea – it becomes an assignment in your name
POST/studio/api/forslag/{id}/angraUndo an order or a dismissal
POST/studio/api/forslag/kampanj/{id}/plockOrder a picks list from a campaign – an assignment in your name
POST/studio/api/forslag/byggFetch new ideas from media monitoring – needs publishing rights

Commerce links

The link monitor and the site's outbound links to affiliate programmes.

GET/studio/api/kop/lankvaktThe link monitor: broken buy links, links without an article ID, pages that don't answer
GET/studio/api/utlankarOutbound links: internal /ut/ paths the site forwards to affiliate programmes
PUT/studio/api/utlankarRegister one or more outbound links
DELETE/studio/api/utlankar/ut/{grupp}/{id}Remove an outbound link

Account, rules and administration

Who you are, the editorial handbook, templates and sections – and, for administrators, agents, roles, settings, log and export.

GET/studio/api/jagWho am I – role, sections, languages and rights
GET/studio/api/handbokThe editorial handbook – the rules for everything written in Studio. Read it at the start of every session.
GET/studio/api/sektionerSections with their compatible templates
GET/studio/api/mallarTemplates – versioned schemas with required fields, allowed blocks and sections (news, feature, list, recipe, picks, guide, review, page, best in test, how-to …)
GET/studio/api/agenterAgent accounts ADMIN
POST/studio/api/agenterCreate an agent account – the key is shown once ADMIN
GET/studio/api/apparThe app library: every app family with its use over 7 and 30 days
GET/studio/api/oversiktThe overview: drafts, review queue, missing languages, upcoming, failed, recently published
GET/studio/api/mallar/{id}One template
PATCH/studio/api/agenter/{id}Change an agent's rights or revoke its key ADMIN
GET/studio/api/rollerThe editors' Studio roles ADMIN
PUT/studio/api/rollerSet role, sections and languages for an account ADMIN
GET/studio/api/installningarSettings: third language, live mode, interface language
PUT/studio/api/installningarChange the settings ADMIN
GET/studio/api/loggThe full log (admin and publishers)
GET/studio/api/exportExport all content, language versions, revisions, media and releases as JSON (admin) – never agent keys
GET/studio/api/openapi.jsonThis specification. ?urval=chatgpt gives the operations a writing agent needs (ChatGPT Actions take at most 30)