summaryrefslogtreecommitdiffstats
path: root/rust/fatcat-openapi
diff options
context:
space:
mode:
authorBryan Newbold <bnewbold@robocracy.org>2019-09-18 20:58:42 -0700
committerBryan Newbold <bnewbold@robocracy.org>2019-09-18 20:58:42 -0700
commit2b3d08dcaa31d9ed999d1904cc2578bda5026505 (patch)
treef9c102f0489c0c2dfe11f5e524454d1c4ac84c36 /rust/fatcat-openapi
parentc0ad5f80c13fc66240a17e59dfff559c6967aac7 (diff)
downloadfatcat-2b3d08dcaa31d9ed999d1904cc2578bda5026505.tar.gz
fatcat-2b3d08dcaa31d9ed999d1904cc2578bda5026505.zip
rust: remove duplicated copies of API spec
Diffstat (limited to 'rust/fatcat-openapi')
-rw-r--r--rust/fatcat-openapi/api.yaml4074
-rw-r--r--rust/fatcat-openapi/api/swagger.yaml10325
2 files changed, 0 insertions, 14399 deletions
diff --git a/rust/fatcat-openapi/api.yaml b/rust/fatcat-openapi/api.yaml
deleted file mode 100644
index 1b533a30..00000000
--- a/rust/fatcat-openapi/api.yaml
+++ /dev/null
@@ -1,4074 +0,0 @@
----
-swagger: "2.0"
-info:
- title: fatcat
- version: 0.3.1
- description: |
- Fatcat is a scalable, versioned, API-oriented catalog of bibliographic
- entities and file metadata.
-
- <!-- STARTLONGDESCRIPTION -->
- These API reference documents, along with client software libraries, are
- generated automatically from an OpenAPI 2.0 ("Swagger") definition file.
-
- ## Introduction
-
-
- A higher-level introduction to the API, as well as a description of the
- fatcat data model, are available in ["The Fatcat Guide"](https://guide.fatcat.wiki/).
- The guide also includes a [Cookbook](https://guide.fatcat.wiki/cookbook.html)
- section demonstrating end-to-end tasks like creating entities as part of
- editgroups, or safely merging duplicate entities.
-
- ### Expectations and Best Practices
-
- A test/staging QA API instance of fatcat is available at
- <https://api.qa.fatcat.wiki/v0>. The database backing this instance is
- separate from the production interface, and is periodically rebuilt from
- snapshots of the full production database, meaning that edits on the QA
- server will *NOT* persist, and that semantics like the changelog index
- monotonically increasing *MAY* be broken. Developers are expexcted to test
- their scripts and tools against the QA instance before running against
- production.
-
- Fatcat is made available as a gratis (no cost) and libre (freedom
- preserving) service to the public, with limited funding and resources. We
- welcome new and unforseen uses and contributions, but may need to impose
- restrictions (like rate-limits) to keep the service functional for other
- users, and in extreme cases reserve the option to block accounts and IP
- ranges if necessary to keep the service operational.
-
- The Internet Archive owns and operates it's own server equipment and data
- centers, and operations are optimized for low-cost, not high-availability.
- Users and partners should expect some downtime on the fatcat API, on the
- order of hours a month.
-
- Periodic metadata exports are available for batch processing, and database
- snapshots can be used to create locally-hosted mirrors of the service for
- more intensive and reliable querying.
-
- ### Other Nitty Gritties
-
- Cross-origin requests are allowed for the API service, to enable third
- parties to bulid in-browser applications.
-
- A metadata search service is available at <https://search.fatcat.wiki> (and
- <https://search.qa.fatcat.wiki>). The API is currently the raw
- elasticsearch API, with only GET (read) requests allowed. This public
- service is experimental and may be removed or limited in the future.
-
- ## Authentication
-
- The API allows basic read-only "GET" HTTP requests with no authentication.
- Proposing changes to the metadata, or other mutating requests ("PUT",
- "POST", "DELETE") all require authentication, and some operations require
- additional account permissions.
-
- End-user account creation and login happens through the web interface. From
- a logged-in editor profile page, you can generate a API token. Tokens are
- "macaroons", similar to JWT tokens, and are used for all API
- authentication. The web interface includes macaroons in browser cookies and
- passes them through to the API to authenticate editor actions.
-
- <!-- ReDoc-Inject: <security-definitions> -->
- <!-- ENDLONGDESCRIPTION -->
-
- termsOfService: "https://guide.fatcat.wiki/policies.html"
- contact:
- name: "Internet Archive Web Group"
- email: "webservices@archive.org"
- url: "https://fatcat.wiki"
- x-logo:
- url: "https://fatcat.wiki/static/paper_man_confused.gif"
- altText: "Confused Papers Man (Logo)"
- backgroundColor: "#FFFFFF"
-schemes: [https]
-basePath: /v0
-host: api.fatcat.wiki
-consumes:
- - application/json
-produces:
- - application/json
-
-x-servers:
-- url: https://api.fatcat.wiki/v0
- description: "Production Server"
-- url: https://api.qa.fatcat.wiki/v0
- description: "QA Server"
-
-securityDefinitions:
- Bearer:
- type: apiKey
- name: Authorization
- in: header
- description: |
- The only current API authentication mechanism is HTTP bearer
- authentication using the `Authorization` HTTP header. The header should
- be formatted as the string "Bearer", then a space, then API token (in the
- usual base64 string encoding).
-
- An example HTTP request would look on the wire like:
-
- GET /v0/auth/check HTTP/1.1
- Accept: */*
- Accept-Encoding: gzip, deflate
- Authorization: Bearer AgEPZGV2LmZhdGNhdC53aWtpAhYyMDE5MDEwMS1kZXYtZHVtbXkta2V5AAImZWRpdG9yX2lkID0gYWFhYWFhYWFhYWFhYmt2a2FhYWFhYWFhYWkAAht0aW1lID4gMjAxOS0wMS0wOVQwMDo1Nzo1MloAAAYgnroNha1hSftChtxHGTnLEmM/pY8MeQS/jBSV0UNvXug=
- Connection: keep-alive
- Host: api.qa.fatcat.wiki
- User-Agent: HTTPie/0.9.8
-
- Headers can be passed on the command line using `http` (HTTPie) like:
-
- http get https://api.qa.fatcat.wiki/v0/auth/check Authorization:"Bearer AgEPZGV2LmZhdGNhdC53aWtpAhYyMDE5MDEwMS1kZXYtZHVtbXkta2V5AAImZWRpdG9yX2lkID0gYWFhYWFhYWFhYWFhYmt2a2FhYWFhYWFhYWkAAht0aW1lID4gMjAxOS0wMS0wOVQwMDo1Nzo1MloAAAYgnroNha1hSftChtxHGTnLEmM/pY8MeQS/jBSV0UNvXug="
-
- Or with `curl`:
-
- curl -H "Authorization: Bearer AgEPZGV2LmZhdGNhdC53aWtpAhYyMDE5MDEwMS1kZXYtZHVtbXkta2V5AAImZWRpdG9yX2lkID0gYWFhYWFhYWFhYWFhYmt2a2FhYWFhYWFhYWkAAht0aW1lID4gMjAxOS0wMS0wOVQwMDo1Nzo1MloAAAYgnroNha1hSftChtxHGTnLEmM/pY8MeQS/jBSV0UNvXug=" https://qa.fatcat.wiki/v0/auth/check
-
-tags: # TAGLINE
- - name: containers # TAGLINE
- x-displayName: "Containers" # TAGLINE
- description: | # TAGLINE
- **Container** entities represent publication venues like journals, # TAGLINE
- conference proceedings, book series, or blogs. They group publications # TAGLINE
- ("releases"). # TAGLINE
-
- See the "Catalog Style Guide" section of the guide for details and # TAGLINE
- semantics of what should be included in specific entity fields. # TAGLINE
- Specifically, the # TAGLINE
- [Container Entity Reference](https://guide.fatcat.wiki/entity_container.html). # TAGLINE
- - name: creators # TAGLINE
- x-displayName: "Creators" # TAGLINE
- description: | # TAGLINE
- **Creator** entities represent individuals (or organizations, or other # TAGLINE
- agents) who contribute to the creation of specific releases # TAGLINE
- (publications). # TAGLINE
-
- See the "Catalog Style Guide" section of the guide for details and # TAGLINE
- semantics of what should be included in specific entity fields. # TAGLINE
- Specifically, the # TAGLINE
- [Creator Entity Reference](https://guide.fatcat.wiki/entity_creator.html). # TAGLINE
- - name: files # TAGLINE
- x-displayName: "Files" # TAGLINE
- description: | # TAGLINE
- **File** entities represent unique digital files which are full # TAGLINE
- manifestations of specific releases (publications), such as fulltext PDF # TAGLINE
- files, JATS XML documents, or video files. File entities also include a # TAGLINE
- set of locations where they can be found on the public web. # TAGLINE
-
- See the "Catalog Style Guide" section of the guide for details and # TAGLINE
- semantics of what should be included in specific entity fields. # TAGLINE
- Specifically, the # TAGLINE
- [File Entity Reference](https://guide.fatcat.wiki/entity_file.html). # TAGLINE
- - name: filesets # TAGLINE
- x-displayName: "Filesets" # TAGLINE
- description: | # TAGLINE
- **Fileset** entities represent sets of digital files, as well as locations # TAGLINE
- where they can be found on the public web. Filesets most commonly # TAGLINE
- represent datasets consisting of serveral data and metadata files. # TAGLINE
-
- See the "Catalog Style Guide" section of the guide for details and # TAGLINE
- semantics of what should be included in specific entity fields. # TAGLINE
- Specifically, the # TAGLINE
- [Fileset Entity Reference](https://guide.fatcat.wiki/entity_fileset.html). # TAGLINE
- - name: webcaptures # TAGLINE
- x-displayName: "Webcaptures" # TAGLINE
- description: | # TAGLINE
- **Web Capture** entities represent archival snapshots of web pages (or # TAGLINE
- other web resources), which are usually complete manifestations of a # TAGLINE
- specific release entity. Web Captures also include a set of locations # TAGLINE
- (wayback replay instances or WARC files) where the capture can be found. # TAGLINE
-
- See the "Catalog Style Guide" section of the guide for details and # TAGLINE
- semantics of what should be included in specific entity fields. # TAGLINE
- Specifically, the # TAGLINE
- [Web Capture Entity Reference](https://guide.fatcat.wiki/entity_webcapture.html). # TAGLINE
- - name: releases # TAGLINE
- x-displayName: "Releases" # TAGLINE
- description: | # TAGLINE
- **Release** entities represent specific published versions of a research # TAGLINE
- work, such as a pre-print, a journal article, a book (or chapter), or a # TAGLINE
- scholarly blog post. Releases are always grouped together under Works; # TAGLINE
- they may be published in a specific Container; they may have known # TAGLINE
- Creators; and there may exist known File/Fileset/WebCapture digital copies # TAGLINE
- of the release. # TAGLINE
-
- See the "Catalog Style Guide" section of the guide for details and # TAGLINE
- semantics of what should be included in specific entity fields. # TAGLINE
- Specifically, the # TAGLINE
- [Release Entity Reference](https://guide.fatcat.wiki/entity_release.html). # TAGLINE
- - name: works # TAGLINE
- x-displayName: "Works" # TAGLINE
- description: | # TAGLINE
- **Work** entities group several Release entities which are different # TAGLINE
- versions of the same abstract piece of research. For example, three # TAGLINE
- release entities representing the pre-print, published article, and # TAGLINE
- retraction stages of the same journal paper would be grouped under a # TAGLINE
- single work. # TAGLINE
-
- See the "Catalog Style Guide" section of the guide for details and # TAGLINE
- semantics of what should be included in specific entity fields. # TAGLINE
- Specifically, the # TAGLINE
- [Work Entity Reference](https://guide.fatcat.wiki/entity_work.html). # TAGLINE
- - name: editgroups # TAGLINE
- x-displayName: "Editgroups" # TAGLINE
- description: | # TAGLINE
- **Editgroups** are sets of changes, each to individual entities in the # TAGLINE
- catalog. Every edit must be part of an editgroup which is reviewed and # TAGLINE
- accepted (merged) as a whole. # TAGLINE
- - name: editors # TAGLINE
- x-displayName: "Editors" # TAGLINE
- description: | # TAGLINE
- **Editors** are human user accounts and bots that make changes to the # TAGLINE
- Fatcat catalog. # TAGLINE
-
- The API allows fetching (and updating) metadata about individual editors, # TAGLINE
- as well as fetching editor's annotation and edit history. # TAGLINE
- - name: changelog # TAGLINE
- x-displayName: "Changelog" # TAGLINE
- description: | # TAGLINE
- The **Changelog** is the ordered feed of editgroups which have been # TAGLINE
- accepted into the catalog. # TAGLINE
- - name: auth # TAGLINE
- x-displayName: "Auth Methods" # TAGLINE
- description: | # TAGLINE
- Helper methods and internal APIs for editor authentication. # TAGLINE
-
-x-tagGroups:
- - name: Entities
- tags:
- - containers
- - creators
- - files
- - filesets
- - webcaptures
- - releases
- - works
- - name: Editing
- tags:
- - editors
- - editgroups
- - changelog
- - name: Other
- tags:
- - auth
-
-# don't want these to be rust types (at least for now)
-x-fatcat-ident: &FATCATIDENT
- type: string
- pattern: "[a-zA-Z2-7]{26}"
- minLength: 26
- maxLength: 26
- description: "base32-encoded unique identifier"
-x-fatcat-ident-example: &FATCATIDENTEXAMPLE
- example: "q3nouwy3nnbsvo3h5klxsx4a7y"
-x-fatcat-uuid: &FATCATUUID
- type: string
- pattern: "[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}"
- minLength: 36
- maxLength: 36
- description: "UUID (lower-case, dash-separated, hex-encoded 128-bit)"
-x-fatcat-uuid-example: &FATCATUUIDEXAMPLE
- example: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
-x-issn: &FATCATISSN
- type: string
- pattern: "\\d{4}-\\d{3}[0-9X]"
- minLength: 9
- maxLength: 9
-x-issn-example: &FATCATISSNEXAMPLE
- example: "1234-5678"
-x-orcid: &FATCATORCID
- type: string
- pattern: "\\d{4}-\\d{4}-\\d{4}-\\d{3}[\\dX]"
- minLength: 19
- maxLength: 19
- description: "ORCiD (https://orcid.org) identifier"
-x-orcid-example: &FATCATORCIDEXAMPLE
- example: "0000-0002-1825-0097"
-x-md5: &FATCATMD5
- type: string
- pattern: "[a-f0-9]{32}"
- minLength: 32
- maxLength: 32
- description: "MD5 hash of data, in hex encoding"
-x-md5-example: &FATCATMD5EXAMPLE
- example: "1b39813549077b2347c0f370c3864b40"
-x-sha1: &FATCATSHA1
- type: string
- pattern: "[a-f0-9]{40}"
- minLength: 40
- maxLength: 40
- description: "SHA-1 hash of data, in hex encoding"
-x-sha1-example: &FATCATSHA1EXAMPLE
- example: "e9dd75237c94b209dc3ccd52722de6931a310ba3"
-x-sha256: &FATCATSHA256
- type: string
- pattern: "[a-f0-9]{64}"
- minLength: 64
- maxLength: 64
- description: "SHA-256 hash of data, in hex encoding"
-x-sha256-example: &FATCATSHA256EXAMPLE
- example: "cb1c378f464d5935ddaa8de28446d82638396c61f042295d7fb85e3cccc9e452"
-
-# Common properties across entities
-x-entity-props: &ENTITYPROPS
- state:
- type: string
- enum: ["wip", "active", "redirect", "deleted"]
- example: "active"
- ident:
- <<: *FATCATIDENT
- <<: *FATCATIDENTEXAMPLE
- revision:
- <<: *FATCATUUID
- <<: *FATCATUUIDEXAMPLE
- redirect:
- <<: *FATCATIDENT
- <<: *FATCATIDENTEXAMPLE
- extra:
- type: object
- description: |
- Free-form JSON metadata that will be stored with the other entity
- metadata. See guide for (unenforced) schema conventions.
- additionalProperties: {}
- edit_extra:
- type: object
- description: |
- Free-form JSON metadata that will be stored with specific entity edits
- (eg, creation/update/delete).
- additionalProperties: {}
-
-definitions:
- error_response:
- type: object
- required:
- - success
- - error
- - message
- properties:
- success:
- type: boolean
- example: false
- error:
- type: string
- example: "unexpected-thing"
- message:
- type: string
- example: "A really confusing, totally unexpected thing happened"
- success:
- type: object
- required:
- - success
- - message
- properties:
- success:
- type: boolean
- example: true
- message:
- type: string
- example: "The computers did the thing successfully!"
- container_entity:
- type: object
- # required for creation: name
- properties:
- <<: *ENTITYPROPS
- name:
- type: string
- description: "Name of the container (eg, Journal title). Required for entity creation."
- example: "Journal of Important Results"
- container_type:
- type: string
- description: "Type of container, eg 'journal' or 'proceedings'. See Guide for list of valid types."
- example: "journal"
- publisher:
- type: string
- description: |
- Name of the organization or entity responsible for publication. Not
- the complete imprint/brand.
- example: "Society of Curious Students"
- issnl:
- description: "Linking ISSN number (ISSN-L). Should be valid and registered with issn.org"
- <<: *FATCATISSN
- <<: *FATCATISSNEXAMPLE
- wikidata_qid:
- type: string
- example: "Q42812"
- creator_entity:
- type: object
- # required for creation: display_name
- properties:
- <<: *ENTITYPROPS
- display_name:
- type: string
- example: "Grace Hopper"
- description: |
- Name as should be displayed in web interface or in author lists (not
- index/sorted). Required for valid entities.
- given_name:
- type: string
- description: |
- In English commonly the first name, but ordering is context and
- culture specific.
- surname:
- type: string
- description: |
- In English commonly the last, or family name, but ordering is context
- and culture specific.
- orcid:
- <<: *FATCATORCID
- <<: *FATCATORCIDEXAMPLE
- wikidata_qid:
- type: string
- example: "Q42812"
- description: "Wikidata entity QID"
- file_entity:
- type: object
- properties:
- <<: *ENTITYPROPS
- size:
- type: integer
- example: 1048576
- format: int64
- description: "Size of file in bytes. Non-zero."
- md5:
- <<: *FATCATMD5
- <<: *FATCATMD5EXAMPLE
- sha1:
- <<: *FATCATSHA1
- <<: *FATCATSHA1EXAMPLE
- sha256:
- <<: *FATCATSHA256
- <<: *FATCATSHA256EXAMPLE
- urls:
- type: array
- items:
- $ref: "#/definitions/file_url"
- mimetype:
- type: string
- example: "application/pdf"
- release_ids:
- type: array
- items:
- <<: *FATCATIDENT
- <<: *FATCATIDENTEXAMPLE
- description: |
- Set of identifier of release entities this file represents a full
- manifestation of. Usually a single release, but some files contain
- content of multiple full releases (eg, an issue of a journal).
- releases:
- description: |
- Full release entities, included in GET responses when `releases`
- included in `expand` parameter. Ignored if included in PUT or POST
- requests.
- type: array
- items:
- $ref: "#/definitions/release_entity"
- file_url:
- type: object
- required:
- - url
- - rel
- properties:
- url:
- type: string
- format: url
- example: "https://example.edu/~frau/prcding.pdf"
- description: |
- URL/URI pointing directly to a machine retrievable copy of this exact
- file.
- rel:
- type: string
- example: "web"
- description: |
- Indicates type of host this URL points to. Eg, "publisher",
- "repository", "webarchive". See guide for list of acceptable values.
- fileset_entity:
- type: object
- properties:
- <<: *ENTITYPROPS
- manifest:
- # limit of 200 files, at least to start
- type: array
- items:
- $ref: "#/definitions/fileset_file"
- urls:
- type: array
- items:
- $ref: "#/definitions/fileset_url"
- release_ids:
- type: array
- items:
- <<: *FATCATIDENT
- <<: *FATCATIDENTEXAMPLE
- description: |
- Set of identifier of release entities this fileset represents a full
- manifestation of. Usually a single release.
- releases:
- type: array
- items:
- $ref: "#/definitions/release_entity"
- description: |
- Full release entities, included in GET responses when `releases`
- included in `expand` parameter. Ignored if included in PUT or POST
- requests.
- fileset_url:
- type: object
- required:
- - url
- - rel
- properties:
- url:
- type: string
- format: url
- example: "https://example.edu/~frau/prcding.pdf"
- rel:
- type: string
- example: "webarchive"
- description: |
- Indicates type of host this URL points to. See guide for list of
- acceptable values.
- fileset_file:
- type: object
- required:
- - path
- - size
- properties:
- path:
- type: string
- example: "img/cat.png"
- description: |
- Path name of file within this fileset (eg, directory)
- size:
- type: integer
- example: 1048576
- format: int64
- description: "File size in bytes"
- md5:
- <<: *FATCATMD5
- <<: *FATCATMD5EXAMPLE
- sha1:
- <<: *FATCATSHA1
- <<: *FATCATSHA1EXAMPLE
- sha256:
- <<: *FATCATSHA256
- <<: *FATCATSHA256EXAMPLE
- extra:
- type: object
- additionalProperties: {}
- description: |
- Free-form additional metadata about this specific file in the set.
- Eg, `mimetype`. See guide for nomative (but unenforced) schema
- fields.
- webcapture_entity:
- type: object
- properties:
- <<: *ENTITYPROPS
- cdx:
- # limit of 200 CDX lines, at least to start?
- type: array
- items:
- $ref: "#/definitions/webcapture_cdx_line"
- archive_urls:
- type: array
- items:
- $ref: "#/definitions/webcapture_url"
- original_url:
- type: string
- format: url
- example: "http://asheesh.org"
- description: "Base URL of the primary resource this is a capture of"
- timestamp:
- type: string
- format: date-time
- description: |
- Same format as CDX line timestamp (UTC, etc). Corresponds to the
- overall capture timestamp. Should generally be the timestamp of
- capture of the primary resource URL.
- release_ids:
- type: array
- items:
- <<: *FATCATIDENT
- <<: *FATCATIDENTEXAMPLE
- description: |
- Set of identifier of release entities this fileset represents a full
- manifestation of. Usually a single release.
- releases:
- type: array
- items:
- $ref: "#/definitions/release_entity"
- description: |
- Full release entities, included in GET responses when `releases`
- included in `expand` parameter. Ignored if included in PUT or POST
- requests.
- webcapture_cdx_line:
- type: object
- required:
- - surt
- - timestamp
- - url
- - sha1
- properties:
- surt:
- type: string
- example: "org,asheesh)/apus/ch1/node15.html"
- description: |
- "Sortable URL" format. See guide for details.
- timestamp:
- type: string
- format: date-time
- example: "2016-09-19T17:20:24Z"
- description: |
- Date and time of capture, in ISO format. UTC, 'Z'-terminated, second
- (or better) precision.
- url:
- type: string
- # NOTE: not format:url to allow alternatives
- example: "http://www.asheesh.org:80/APUS/ch1/node15.html"
- description: |
- Full URL/URI of resource captured.
- mimetype:
- type: string
- example: "text/html"
- description: |
- Mimetype of the resource at this URL. May be the Content-Type header,
- or the actually sniffed file type.
- status_code:
- type: integer
- example: 200
- format: int64
- description: |
- HTTP status code. Should generally be 200, especially for the primary
- resource, but may be 3xx (redirect) or even error codes if embedded
- resources can not be fetched successfully.
- size:
- type: integer
- example: 1048576
- format: int64
- description: "Resource (file) size in bytes"
- sha1:
- <<: *FATCATSHA1
- <<: *FATCATSHA1EXAMPLE
- sha256:
- <<: *FATCATSHA256
- <<: *FATCATSHA256EXAMPLE
- webcapture_url:
- type: object
- required:
- - url
- - rel
- properties:
- url:
- type: string
- format: url
- example: "https://web.archive.org/web/"
- description: |
- URL/URI pointing to archive of this web resource.
- rel:
- type: string
- example: "wayback"
- description: |
- Type of archive endpoint. Usually `wayback` (WBM replay of primary
- resource), or `warc` (direct URL to a WARC file containing all
- resources of the capture). See guide for full list.
- release_entity:
- type: object
- # required for creation: title
- required:
- - ext_ids
- properties:
- <<: *ENTITYPROPS
- title:
- type: string
- description: |
- Required for valid entities. The title used in citations and for
- display. Sometimes the English translation of title e even if release
- content is not English.
- subtitle:
- type: string
- description: |
- Subtitle of release. In many cases, better to merge with title than
- include as separate field (unless combined title would be very long).
- See guide for details.
- original_title:
- type: string
- description: |
- Title in original language if `title` field has been translated. See
- guide for details.
- work_id:
- type: string
- example: "q3nouwy3nnbsvo3h5klxsx4a7y"
- description: |
- Identifier of work this release is part of. In creation (POST)
- requests, a work entity will be created automatically if this field
- is not set.
- container:
- $ref: "#/definitions/container_entity"
- description: |
- Complete container entity identified by `container_id` field. Only
- included in GET reponses when `container` included in `expand`
- parameter; ignored in PUT or POST requests.
- files:
- type: array
- items:
- $ref: "#/definitions/file_entity"
- description: |
- Complete file entities identified by `file_ids` field. Only
- included in GET responses when `files` included in `expand` parameter;
- ignored in PUT or POST requests.
- filesets:
- type: array
- items:
- $ref: "#/definitions/fileset_entity"
- description: |
- Complete file entities identified by `filesets_ids` field. Only
- included in GET responses when `filesets` included in `expand`
- parameter; ignored in PUT or POST requests.
- webcaptures:
- type: array
- items:
- $ref: "#/definitions/webcapture_entity"
- description: |
- Complete webcapture entities identified by `webcapture_ids` field.
- Only included in GET responses when `webcaptures` included in `expand`
- parameter; ignored in PUT or POST requests.
- container_id:
- type: string
- example: "q3nouwy3nnbsvo3h5klxsx4a7y"
- description: |
- Used to link this release to a container entity that the release was
- published as part of.
- release_type:
- type: string
- example: "book"
- description: |
- "Type" or "medium" that this release is published as. See guide for
- valid values.
- release_stage:
- type: string
- example: "preprint"
- description: |
- The stage of publication of this specific release. See guide for
- valid values and semantics.
- release_date:
- type: string
- format: date
- description: |
- Full date when this release was formally published. ISO format, like
- `2019-03-05`. See guide for semantics.
- release_year:
- type: integer
- example: 2014
- format: int64
- description: |
- Year when this release was formally published. Must match
- `release_date` if that field is set; this field exists because
- sometimes only the year is known.
- withdrawn_status:
- type: string
- example: "retracted"
- description: |
- Type of withdrawl or retraction of this release, if applicable. If
- release has not been withdrawn, should be `null` (aka, not set, not
- the string "null" or an empty string).
- withdrawn_date:
- type: string
- format: date
- description: |
- Full date when this release was formally withdrawn (if applicable).
- ISO format, like `release_date`.
- withdrawn_year:
- type: integer
- example: 2014
- format: int64
- description: |
- Year corresponding with `withdrawn_date` like
- `release_year`/`release_date`.
- ext_ids:
- $ref: "#/definitions/release_ext_ids"
- description: |
- Set of external identifiers for this release.
- volume:
- type: string
- example: "3"
- description: |
- Volume number of container that this release was published in. Often
- corresponds to the "Nth" year of publication, but can be any string.
- See guide.
- issue:
- type: string
- example: "12"
- description: |
- Issue number of volume/container that this release was published in.
- Sometimes coresponds to a month number in the year, but can be any
- string. See guide.
- pages:
- type: string
- example: "340-345"
- description: |
- Either a single page number ("first page") or a range of pages
- separated by a dash ("-"). See guide for details.
- number:
- type: string
- example: "RFC1337"
- description: |
- For, eg, technical reports, which are published in series or
- assigned some other institutional or container-specific identifier.
- version:
- type: string
- example: "3"
- description: |
- For, eg, updated technical reports or software packages, where
- the version string may be the only field disambiguating between
- releases.
- publisher:
- type: string
- example: "Elsevier"
- description: |
- Name, usually English, of the entity or institution responsible for
- publication of this release. Not necessarily the imprint/brand. See
- guide.
- language:
- type: string
- example: "en"
- description: |
- Primary language of the content of the full release. Two-letter
- RFC1766/ISO639-1 language code, with some custom
- extensions/additions. See guide.
- license_slug:
- type: string
- example: "CC-BY"
- description: |
- Short string (slug) name of license under which release is openly
- published (if applicable).
- contribs:
- type: array
- items:
- $ref: "#/definitions/release_contrib"
- refs:
- type: array
- items:
- $ref: "#/definitions/release_ref"
- abstracts:
- type: array
- items:
- $ref: "#/definitions/release_abstract"
- release_ext_ids:
- type: object
- properties:
- doi:
- type: string
- #format: custom
- example: "10.1234/abcde.789"
- description: |
- Digital Object Identifier (DOI), mostly for published papers and
- datasets. Should be registered and resolvable via https://doi.org/
- wikidata_qid:
- type: string
- example: "Q42812"
- description: "Wikidata entity QID"
- isbn13:
- type: string
- #format: custom
- description: |
- ISBN-13, for books. Usually not set for chapters. ISBN-10 should be
- converted to ISBN-13.
- pmid:
- type: string
- example: "482132"
- description: "PubMed Identifier"
- pmcid:
- example: "PMC7391"
- type: string
- description: "PubMed Central Identifier"
- core:
- exmaple: "9234592"
- type: string
- #format: custom
- description: "CORE (https://core.ac.uk) identifier"
- arxiv:
- type: string
- description: "arXiv (https://arxiv.org) identifier; must include version"
- jstor:
- type: string
- description: "JSTOR work identifier"
- ark:
- type: string
- description: "ARK identifier"
- mag:
- type: string
- description: "Microsoft Academic Graph identifier"
- release_abstract:
- type: object
- properties:
- sha1:
- <<: *FATCATSHA1
- <<: *FATCATSHA1EXAMPLE
- content:
- type: string
- example: "<jats:p>Some abstract thing goes here</jats:p>"
- description: |
- Abstract content. May be encoded, as per `mimetype` field, but only
- string/text content may be included.
- mimetype:
- type: string
- example: "application/xml+jats"
- description: |
- Mimetype of abstract contents. `text/plain` is the default if content
- isn't encoded.
- lang:
- type: string
- example: "en"
- description: |
- ISO language code of the abstract. Same semantics as release `language` field.
- work_entity:
- type: object
- properties:
- <<: *ENTITYPROPS
- entity_history_entry:
- type: object
- required:
- - edit
- - editgroup
- - changelog_entry
- properties:
- edit:
- $ref: "#/definitions/entity_edit"
- editgroup:
- $ref: "#/definitions/editgroup"
- changelog_entry:
- $ref: "#/definitions/changelog_entry"
- entity_edit:
- type: object
- required:
- - edit_id
- - ident
- - editgroup_id
- properties:
- edit_id:
- <<: *FATCATUUID
- <<: *FATCATUUIDEXAMPLE
- description: |
- Unique UUID for this specific edit object.
- ident:
- <<: *FATCATIDENT
- <<: *FATCATIDENTEXAMPLE
- description: |
- Fatcat identifier of the entity this edit is mutating.
- revision:
- <<: *FATCATUUID
- <<: *FATCATUUIDEXAMPLE
- description: |
- Entity revision that this edit will set the entity to. May be
- `null` in the case of deletions.
- prev_revision:
- <<: *FATCATUUID
- <<: *FATCATUUIDEXAMPLE
- description: |
- Revision of entity just before this edit. May be used in the future
- to prevent edit race conditions.
- redirect_ident:
- <<: *FATCATIDENT
- <<: *FATCATIDENTEXAMPLE
- description: |
- When an edit is to merge entities (redirect one to another), this
- is the entity fatcat identifier for the target entity.
- editgroup_id:
- <<: *FATCATIDENT
- <<: *FATCATIDENTEXAMPLE
- description: |
- Editgroup identifier that this edit is part of.
- extra:
- type: object
- additionalProperties: {}
- editor:
- type: object
- required:
- - username
- properties:
- editor_id:
- <<: *FATCATIDENT
- <<: *FATCATIDENTEXAMPLE
- description: |
- Fatcat identifier for the editor. Can not be changed.
- username:
- type: string
- example: "zerocool93"
- description: |
- Username/handle (short slug-like string) to identify this editor. May
- be changed at any time by the editor; use the `editor_id` as a
- persistend identifer.
- is_admin:
- type: boolean
- example: false
- description: |
- Whether this editor has the `admin` role.
- is_bot:
- type: boolean
- example: false
- description: |
- Whether this editor is a bot (as opposed to a human making manual
- edits)
- is_active:
- type: boolean
- example: true
- description: |
- Whether this editor's account is enabled (if not API tokens and web
- logins will not work).
- editgroup:
- type: object
- properties:
- editgroup_id:
- <<: *FATCATIDENT
- <<: *FATCATIDENTEXAMPLE
- description: |
- Fatcat identifier for this editgroup. Assigned on creation.
- editor_id:
- <<: *FATCATIDENT
- <<: *FATCATIDENTEXAMPLE
- description: |
- Fatcat identifer of editor that created this editgroup.
- editor:
- $ref: "#/definitions/editor"
- description: |
- Complete editor object identified by `container_id` field. Only
- included in GET responses.
- changelog_index: # not returned in all contexts...
- type: integer
- example: 1048576
- format: int64
- description: |
- For accepted/merged editgroups, the changelog index that the accept
- occured at. WARNING: not populated in all contexts that an editgroup
- could be included in a response.
- created:
- type: string
- format: date-time
- description: |
- Timestamp when this editgroup was first created.
- submitted:
- type: string
- format: date-time
- description: |
- Timestamp when this editgroup was most recently submitted for review.
- If withdrawn, or never submitted, will be `null`.
- description:
- type: string
- description: |
- Comment describing the changes in this editgroup. Can be updated with
- PUT request.
- extra:
- type: object
- additionalProperties: {}
- description: |
- Free-form JSON metadata attached to this editgroup. Eg, metadata
- provenance, or script user-agent details. See guide for (unenforced)
- schema norms.
- annotations:
- type: array
- items:
- $ref: "#/definitions/editgroup_annotation"
- description: |
- Only included in GET responses, and not in all contexts. Do not
- include this field in PUT or POST requests.
- edits:
- type: object
- description: |
- Only included in GET responses, and not in all contexts. Do not
- include this field in PUT or POST requests.
- properties:
- containers:
- type: array
- items:
- $ref: "#/definitions/entity_edit"
- creators:
- type: array
- items:
- $ref: "#/definitions/entity_edit"
- files:
- type: array
- items:
- $ref: "#/definitions/entity_edit"
- filesets:
- type: array
- items:
- $ref: "#/definitions/entity_edit"
- webcaptures:
- type: array
- items:
- $ref: "#/definitions/entity_edit"
- releases:
- type: array
- items:
- $ref: "#/definitions/entity_edit"
- works:
- type: array
- items:
- $ref: "#/definitions/entity_edit"
- editgroup_annotation:
- type: object
- properties:
- annotation_id:
- <<: *FATCATUUID
- <<: *FATCATUUIDEXAMPLE
- editgroup_id:
- <<: *FATCATIDENT
- <<: *FATCATIDENTEXAMPLE
- description: |
- Editgroup that this annotation applies to. Set automatically in
- creations based on URL parameter.
- editor_id:
- <<: *FATCATIDENT
- <<: *FATCATIDENTEXAMPLE
- description: |
- Defaults to editor created the annotation via POST request.
- editor:
- $ref: "#/definitions/editor"
- description: |
- Only included in GET responses; ignored in PUT or POST requests.
- created:
- type: string
- format: date-time
- description: |
- Timestamp when annotation was first created.
- comment_markdown:
- type: string
- extra:
- type: object
- additionalProperties: {}
- description: |
- Additional free-form JSON metadata that can be included as part of
- the annotation (or even as the primary annotation itself). See guide
- for details.
- changelog_entry:
- type: object
- required:
- - index
- - editgroup_id
- - timestamp
- properties:
- index:
- type: integer
- format: int64
- description: |
- Monotonically increasing sequence number of this changelog entry.
- editgroup_id:
- type: string
- example: "q3nouwy3nnbsvo3h5klxsx4a7y"
- description: |
- Identifier of editgroup accepted/merged in this changelog entry.
- timestamp:
- type: string
- format: date-time
- description: |
- Date and time when the editgroup was accpeted.
- editgroup:
- $ref: "#/definitions/editgroup"
- release_ref:
- type: object
- properties:
- index:
- type: integer
- format: int64
- description: |
- Zero-indexed sequence number of this reference in the list of
- references. Assigned automatically and used internally; don't confuse
- with `key`.
- target_release_id:
- <<: *FATCATIDENT
- <<: *FATCATIDENTEXAMPLE
- description: |
- Optional, fatcat identifier of release entity that this reference is
- citing.
- extra:
- type: object
- additionalProperties: {}
- description: |
- Additional free-form JSON metadata about this citation. Generally
- follows Citation Style Language (CSL) JSON schema. See guide for
- details.
- key:
- type: string
- example: "SMITH2016"
- description: |
- Short string used to indicate this reference from within the release
- text; or numbering of references as typeset in the release itself.
- Optional; don't confuse with `index` field.
- year:
- type: integer
- format: int64
- example: 1972
- description: |
- Year that the cited work was published in.
- container_name:
- type: string
- description: |
- Name of the container (eg, journal) that the citation work was
- published as part of. May be an acronym or full name.
- title:
- type: string
- description:
- Name of the work being cited.
- locator:
- type: string
- example: "p123"
- description: |
- Page number or other indicator of the specific subset of a work being
- cited. Not to be confused with the first page (or page range) of an
- entire paper or chapter being cited.
- release_contrib:
- type: object
- properties:
- index:
- type: integer
- format: int64
- example: 0
- description: |
- Internally assigned zero-indexed sequence number of contribution.
- Authors should come first; this encodes the order of attriubtion.
- creator_id:
- <<: *FATCATIDENT
- <<: *FATCATIDENTEXAMPLE
- description: |
- If known, indicates the creator entity this contribution was made by.
- creator:
- $ref: "#/definitions/creator_entity"
- description: |
- Complete creator entity. Only returned in GET responses, and only if
- `contribs` included in the `expand` query parameter.
- raw_name:
- type: string
- example: "Jane K. Doe"
- description: |
- Full name of the contributor as typeset in the release.
- given_name:
- type: string
- example: "Jane"
- description: |
- In English commonly the first name, but ordering is context and
- culture specific.
- surname:
- type: string
- example: "Doe"
- description: |
- In English commonly the last, or family name, but ordering is context
- and culture specific.
- role:
- type: string
- example: "author"
- description: |
- Short string (slug) indicating type of contribution (eg, "author",
- "translator"). See guide for list of accpeted values.
- raw_affiliation:
- type: string
- description: "Raw affiliation string as displayed in text"
- extra:
- type: object
- additionalProperties: {}
- description: |
- Additional free-form JSON metadata about this
- contributor/contribution. See guide for normative schema.
- container_auto_batch:
- type: object
- required:
- - editgroup
- - entity_list
- properties:
- editgroup:
- $ref: "#/definitions/editgroup"
- entity_list:
- type: array
- items:
- $ref: "#/definitions/container_entity"
- creator_auto_batch:
- type: object
- required:
- - editgroup
- - entity_list
- properties:
- editgroup:
- $ref: "#/definitions/editgroup"
- entity_list:
- type: array
- items:
- $ref: "#/definitions/creator_entity"
- file_auto_batch:
- type: object
- required:
- - editgroup
- - entity_list
- properties:
- editgroup:
- $ref: "#/definitions/editgroup"
- entity_list:
- type: array
- items:
- $ref: "#/definitions/file_entity"
- fileset_auto_batch:
- type: object
- required:
- - editgroup
- - entity_list
- properties:
- editgroup:
- $ref: "#/definitions/editgroup"
- entity_list:
- type: array
- items:
- $ref: "#/definitions/fileset_entity"
- webcapture_auto_batch:
- type: object
- required:
- - editgroup
- - entity_list
- properties:
- editgroup:
- $ref: "#/definitions/editgroup"
- entity_list:
- type: array
- items:
- $ref: "#/definitions/webcapture_entity"
- release_auto_batch:
- type: object
- required:
- - editgroup
- - entity_list
- properties:
- editgroup:
- $ref: "#/definitions/editgroup"
- entity_list:
- type: array
- items:
- $ref: "#/definitions/release_entity"
- work_auto_batch:
- type: object
- required:
- - editgroup
- - entity_list
- properties:
- editgroup:
- $ref: "#/definitions/editgroup"
- entity_list:
- type: array
- items:
- $ref: "#/definitions/work_entity"
- auth_oidc:
- type: object
- required:
- - provider
- - sub
- - iss
- - preferred_username
- properties:
- provider:
- type: string
- example: "orcid"
- description: |
- Fatcat-specific short name (slug) for remote service being used for
- authentication.
- sub:
- type: string
- description: "`SUB` from OIDC protocol. Usually a URL."
- example: "https://orcid.org"
- iss:
- type: string
- description: "`ISS` from OIDC protocol. Usually a stable account username, number, or identifier."
- example: "0000-0002-8593-9468"
- preferred_username:
- type: string
- description: |
- What it sounds like; returned by OIDC, and used as a hint when
- creating new editor accounts. Fatcat usernames are usually this
- string with the `provider` slug as a suffix, though some munging may
- occur.
- example: "bnewbold"
- auth_oidc_result:
- type: object
- required:
- - editor
- - token
- properties:
- editor:
- $ref: "#/definitions/editor"
- token:
- type: string
- example: "AgEPZGV2LmZhdGNhdC53aWtpAhYyMDE5MDEwMS1kZXYtZHVtbXkta2V5AAImZWRpdG9yX2lkID0gYWFhYWFhYWFhYWFhYmt2a2FhYWFhYWFhYWkAAht0aW1lID4gMjAxOS0wMS0wOVQwMDo1Nzo1MloAAAYgnroNha1hSftChtxHGTnLEmM/pY8MeQS/jBSV0UNvXug="
- auth_token_result:
- type: object
- required:
- - token
- properties:
- token:
- type: string
- example: "AgEPZGV2LmZhdGNhdC53aWtpAhYyMDE5MDEwMS1kZXYtZHVtbXkta2V5AAImZWRpdG9yX2lkID0gYWFhYWFhYWFhYWFhYmt2a2FhYWFhYWFhYWkAAht0aW1lID4gMjAxOS0wMS0wOVQwMDo1Nzo1MloAAAYgnroNha1hSftChtxHGTnLEmM/pY8MeQS/jBSV0UNvXug="
-
-x-auth-responses: &AUTHRESPONSES
- 401:
- description: Not Authorized # "Authentication information is missing or invalid"
- schema:
- $ref: "#/definitions/error_response"
- headers:
- WWW_Authenticate:
- type: string
- 403:
- description: Forbidden
- schema:
- $ref: "#/definitions/error_response"
-x-entity-responses: &ENTITYRESPONSES
- 400:
- description: Bad Request
- schema:
- $ref: "#/definitions/error_response"
- 404:
- description: Not Found
- schema:
- $ref: "#/definitions/error_response"
- 500:
- description: Generic Error
- schema:
- $ref: "#/definitions/error_response"
-
-paths:
- /editgroup/{editgroup_id}/container:
- parameters:
- - name: editgroup_id
- in: path
- type: string
- required: true
- post:
- operationId: "create_container"
- tags: # TAGLINE
- - containers # TAGLINE
- description: |
- Create a single Container entity as part of an existing editgroup.
-
- Editgroup must be mutable (aka, not accepted) and editor must have
- permission (aka, have created the editgrou p or have `admin` role).
- parameters:
- - name: entity
- in: body
- required: true
- schema:
- $ref: "#/definitions/container_entity"
- security:
- - Bearer: []
- responses:
- 201:
- description: Created Entity
- schema:
- $ref: "#/definitions/entity_edit"
- <<: *ENTITYRESPONSES
- <<: *AUTHRESPONSES
- /editgroup/auto/container/batch:
- post:
- operationId: "create_container_auto_batch"
- tags: # TAGLINE
- - containers # TAGLINE
- description: |
- Create a set of Container entities as part of a new editgroup, and
- accept that editgroup in the same atomic request.
-
- This method is mostly useful for bulk import of new entities by
- carefully written bots. This method is more efficient than creating an
- editgroup, several entities, then accepting the editgroup, both in
- terms of API requests required and database load. Requires `admin`
- role.
- parameters:
- - name: auto_batch
- in: body
- required: true
- schema:
- $ref: "#/definitions/container_auto_batch"
- security:
- - Bearer: []
- responses:
- 201:
- description: Created Editgroup
- schema:
- $ref: "#/definitions/editgroup"
- <<: *ENTITYRESPONSES
- <<: *AUTHRESPONSES
- /container/{ident}:
- parameters:
- - name: ident
- in: path
- type: string
- required: true
- get:
- operationId: "get_container"
- tags: # TAGLINE
- - containers # TAGLINE
- description: |
- Fetches a single container entity from the catalog.
- parameters:
- - name: expand
- in: query
- type: string
- required: false
- description: "List of sub-entities to expand in response. For containers, none accepted (yet)."
- - name: hide
- in: query
- type: string
- required: false
- description: "List of entity fields to elide in response. For containers, none accepted (yet)."
- responses:
- 200:
- description: Found Entity
- schema:
- $ref: "#/definitions/container_entity"
- <<: *ENTITYRESPONSES
- /editgroup/{editgroup_id}/container/{ident}:
- parameters:
- - name: editgroup_id
- in: path
- type: string
- required: true
- - name: ident
- in: path
- type: string
- required: true
- put:
- operationId: "update_container"
- tags: # TAGLINE
- - containers # TAGLINE
- description: |
- Updates an existing entity as part of a specific (existing) editgroup.
- The editgroup must be open for updates (aka, not accepted/merged), and
- the editor making the requiest must have permissions (aka, must have
- created the editgroup or have `admin` role).
-
- This method can also be used to update an existing entity edit as part
- of an editgroup. For example, if an entity was created in this
- editgroup, an editor could make changes to the new entity's metadata
- before merging.
- parameters:
- - name: entity
- in: body
- required: true
- schema:
- $ref: "#/definitions/container_entity"
- security:
- - Bearer: []
- responses:
- 200:
- description: Updated Entity
- schema:
- $ref: "#/definitions/entity_edit"
- <<: *ENTITYRESPONSES
- <<: *AUTHRESPONSES
- delete:
- operationId: "delete_container"
- tags: # TAGLINE
- - containers # TAGLINE
- description: |
- Creates a new "deletion" edit for a specific entity as part of an
- existing editgroup.
-
- This is not the method to use to remove an edit from an editgroup; for
- that use `delete_container_edit`.
- security:
- - Bearer: []
- responses:
- 200:
- description: Deleted Entity
- schema:
- $ref: "#/definitions/entity_edit"
- <<: *ENTITYRESPONSES
- <<: *AUTHRESPONSES
- /container/rev/{rev_id}:
- parameters:
- - name: rev_id
- in: path
- required: true
- <<: *FATCATUUID
- get:
- operationId: "get_container_revision"
- tags: # TAGLINE
- - containers # TAGLINE
- description: |
- Fetches a specific entity revision. Note that the returned revision
- will not be associated with any particular fatcat identifier (even if
- one or more identifiers do currently point to this revision). The
- revision may even be part of an un-merged editgroup.
-
- Revisions are immutable and can not be deleted or updated.
- parameters:
- - name: expand
- in: query
- type: string
- required: false
- description: "List of sub-entities to expand in response. See `get_container`."
- - name: hide
- in: query
- type: string
- required: false
- description: "List of entity fields to elide in response. See `get_container`."
- responses:
- 200:
- description: Found Entity Revision
- schema:
- $ref: "#/definitions/container_entity"
- <<: *ENTITYRESPONSES
- /container/{ident}/history:
- parameters:
- - name: ident
- in: path
- type: string
- required: true
- - name: limit
- in: query
- type: integer
- format: int64
- required: false
- description: "Maximum number of changelog entries to return"
- get:
- tags: # TAGLINE
- - containers # TAGLINE
- description: |
- Fetches the history of accepted edits (changelog entries) for a
- specific entity fatcat identifier.
- operationId: "get_container_history"
- responses:
- 200:
- description: Found Entity History
- schema:
- type: array
- items:
- $ref: "#/definitions/entity_history_entry"
- <<: *ENTITYRESPONSES
- /container/{ident}/redirects:
- parameters:
- - name: ident
- in: path
- type: string
- required: true
- get:
- operationId: "get_container_redirects"
- tags: # TAGLINE
- - containers # TAGLINE
- description: |
- Returns the set of entity identifiers which currently redirect to this
- identifier.
- responses:
- 200:
- description: Found Entity Redirects
- schema:
- type: array
- items:
- <<: *FATCATIDENT
- <<: *ENTITYRESPONSES
- /container/lookup:
- get:
- operationId: "lookup_container"
- tags: # TAGLINE
- - containers # TAGLINE
- description: |
- Looks for an active entity with the given external identifier. If any
- such entity is found, returns a single complete entity. If multiple
- entities have the same external identifier, this is considered a soft
- catalog error, and the behavior of which entity is returned is
- undefined.
-
- One (and only one) external identifier should be specified per request.
- parameters:
- - name: issnl
- in: query
- required: false
- <<: *FATCATISSN
- - name: wikidata_qid
- in: query
- type: string
- required: false
- - name: expand
- in: query
- type: string
- required: false
- description: "List of sub-entities to expand in response. See `get_container`."
- - name: hide
- in: query
- type: string
- required: false
- description: "List of entity fields to elide in response. See `get_container`."
- responses:
- 200:
- description: Found Entity
- schema:
- $ref: "#/definitions/container_entity"
- <<: *ENTITYRESPONSES
- /container/edit/{edit_id}:
- get:
- operationId: "get_container_edit"
- tags: # TAGLINE
- - containers # TAGLINE
- description: |
- Returns the entity edit object with the given identifier. This method
- is expected to be used rarely.
- parameters:
- - name: edit_id
- in: path
- required: true
- <<: *FATCATUUID
- responses:
- 200:
- description: Found Edit
- schema:
- $ref: "#/definitions/entity_edit"
- <<: *ENTITYRESPONSES
- /editgroup/{editgroup_id}/container/edit/{edit_id}:
- parameters:
- - name: editgroup_id
- in: path
- required: true
- type: string
- - name: edit_id
- in: path
- required: true
- <<: *FATCATUUID
- delete:
- operationId: "delete_container_edit"
- tags: # TAGLINE
- - containers # TAGLINE
- description: |
- Removes a single edit from the specified editgroup. The editgroup must
- be mutable (aka, not accepted/merged), and the editor making this
- request must have permission (aka, have created the editgroup or hold
- the `admin` role).
-
- Not to be confused with the `delete_container` method, which *creates*
- a new edit in the given editgroup.
- security:
- - Bearer: []
- responses:
- 200:
- description: Deleted Edit
- schema:
- $ref: "#/definitions/success"
- <<: *ENTITYRESPONSES
- <<: *AUTHRESPONSES
-
- /editgroup/{editgroup_id}/creator:
- parameters:
- - name: editgroup_id
- in: path
- type: string
- required: true
- post:
- operationId: "create_creator"
- tags: # TAGLINE
- - creators # TAGLINE
- parameters:
- - name: entity
- in: body
- required: true
- schema:
- $ref: "#/definitions/creator_entity"
- security:
- - Bearer: []
- responses:
- 201:
- description: Created Entity
- schema:
- $ref: "#/definitions/entity_edit"
- <<: *ENTITYRESPONSES
- <<: *AUTHRESPONSES
- /editgroup/auto/creator/batch:
- post:
- operationId: "create_creator_auto_batch"
- tags: # TAGLINE
- - creators # TAGLINE
- parameters:
- - name: auto_batch
- in: body
- required: true
- schema:
- $ref: "#/definitions/creator_auto_batch"
- security:
- - Bearer: []
- responses:
- 201:
- description: Created Editgroup
- schema:
- $ref: "#/definitions/editgroup"
- <<: *ENTITYRESPONSES
- <<: *AUTHRESPONSES
- /creator/{ident}:
- parameters:
- - name: ident
- in: path
- type: string
- required: true
- get:
- operationId: "get_creator"
- tags: # TAGLINE
- - creators # TAGLINE
- parameters:
- - name: expand
- in: query
- type: string
- required: false
- description: "List of sub-entities to expand in response. For creators, none accepted (yet)."
- - name: hide
- in: query
- type: string
- required: false
- description: "List of entity fields to elide in response. For creators, none accepted (yet)."
- responses:
- 200:
- description: Found Entity
- schema:
- $ref: "#/definitions/creator_entity"
- <<: *ENTITYRESPONSES
- /editgroup/{editgroup_id}/creator/{ident}:
- parameters:
- - name: editgroup_id
- in: path
- type: string
- required: true
- - name: ident
- in: path
- type: string
- required: true
- put:
- operationId: "update_creator"
- tags: # TAGLINE
- - creators # TAGLINE
- parameters:
- - name: entity
- in: body
- required: true
- schema:
- $ref: "#/definitions/creator_entity"
- security:
- - Bearer: []
- responses:
- 200:
- description: Updated Entity
- schema:
- $ref: "#/definitions/entity_edit"
- <<: *ENTITYRESPONSES
- <<: *AUTHRESPONSES
- delete:
- operationId: "delete_creator"
- tags: # TAGLINE
- - creators # TAGLINE
- security:
- - Bearer: []
- responses:
- 200:
- description: Deleted Entity
- schema:
- $ref: "#/definitions/entity_edit"
- <<: *ENTITYRESPONSES
- <<: *AUTHRESPONSES
- /creator/rev/{rev_id}:
- parameters:
- - name: rev_id
- in: path
- required: true
- <<: *FATCATUUID
- get:
- operationId: "get_creator_revision"
- tags: # TAGLINE
- - creators # TAGLINE
- parameters:
- - name: expand
- in: query
- type: string
- required: false
- description: |
- List of sub-entities to expand in response. See `get_creator`,
- though note that identifier-based expansions (like `releases`) will
- always be empty for revisions.
- - name: hide
- in: query
- type: string
- required: false
- description: "List of entity fields to elide in response. See `get_creator`."
- responses:
- 200:
- description: Found Entity Revision
- schema:
- $ref: "#/definitions/creator_entity"
- <<: *ENTITYRESPONSES
- /creator/{ident}/history:
- parameters:
- - name: ident
- in: path
- type: string
- required: true
- - name: limit
- in: query
- type: integer
- format: int64
- required: false
- get:
- operationId: "get_creator_history"
- tags: # TAGLINE
- - creators # TAGLINE
- responses:
- 200:
- description: Found Entity History
- schema:
- type: array
- items:
- $ref: "#/definitions/entity_history_entry"
- <<: *ENTITYRESPONSES
- /creator/{ident}/releases:
- parameters:
- - name: ident
- in: path
- type: string
- required: true
- - name: hide
- in: query
- type: string
- required: false
- description: "List of entity fields to elide in response. See `get_release`."
- get:
- operationId: "get_creator_releases"
- tags: # TAGLINE
- - creators # TAGLINE
- description: |
- Returns the set of Release entities having a `contrib` entry pointing
- to the creator entity.
- responses:
- 200:
- description: Found
- schema:
- type: array
- items:
- $ref: "#/definitions/release_entity"
- <<: *ENTITYRESPONSES
- /creator/{ident}/redirects:
- parameters:
- - name: ident
- in: path
- type: string
- required: true
- get:
- operationId: "get_creator_redirects"
- tags: # TAGLINE
- - creators # TAGLINE
- responses:
- 200:
- description: Found Entity Redirects
- schema:
- type: array
- items:
- <<: *FATCATIDENT
- <<: *ENTITYRESPONSES
- /creator/lookup:
- get:
- operationId: "lookup_creator"
- tags: # TAGLINE
- - creators # TAGLINE
- parameters:
- - name: orcid
- in: query
- required: false
- <<: *FATCATORCID
- - name: wikidata_qid
- in: query
- type: string
- required: false
- - name: expand
- in: query
- type: string
- required: false
- description: "List of sub-entities to expand in response. See `get_creator`."
- - name: hide
- in: query
- type: string
- required: false
- description: "List of entity fields to elide in response. See `get_creator`."
- responses:
- 200:
- description: Found Entity
- schema:
- $ref: "#/definitions/creator_entity"
- <<: *ENTITYRESPONSES
- /creator/edit/{edit_id}:
- get:
- operationId: "get_creator_edit"
- tags: # TAGLINE
- - creators # TAGLINE
- parameters:
- - name: edit_id
- in: path
- required: true
- <<: *FATCATUUID
- responses:
- 200:
- description: Found Edit
- schema:
- $ref: "#/definitions/entity_edit"
- <<: *ENTITYRESPONSES
- /editgroup/{editgroup_id}/creator/edit/{edit_id}:
- parameters:
- - name: editgroup_id
- in: path
- required: true
- type: string
- - name: edit_id
- in: path
- required: true
- <<: *FATCATUUID
- delete:
- operationId: "delete_creator_edit"
- tags: # TAGLINE
- - creators # TAGLINE
- security:
- - Bearer: []
- responses:
- 200:
- description: Deleted Edit
- schema:
- $ref: "#/definitions/success"
- <<: *ENTITYRESPONSES
- <<: *AUTHRESPONSES
-
- /editgroup/{editgroup_id}/file:
- parameters:
- - name: editgroup_id
- in: path
- type: string
- required: true
- post:
- operationId: "create_file"
- tags: # TAGLINE
- - files # TAGLINE
- parameters:
- - name: entity
- in: body
- required: true
- schema:
- $ref: "#/definitions/file_entity"
- security:
- - Bearer: []
- responses:
- 201:
- description: Created Entity
- schema:
- $ref: "#/definitions/entity_edit"
- <<: *ENTITYRESPONSES
- <<: *AUTHRESPONSES
- /editgroup/auto/file/batch:
- post:
- operationId: "create_file_auto_batch"
- tags: # TAGLINE
- - files # TAGLINE
- parameters:
- - name: auto_batch
- in: body
- required: true
- schema:
- $ref: "#/definitions/file_auto_batch"
- security:
- - Bearer: []
- responses:
- 201:
- description: Created Editgroup
- schema:
- $ref: "#/definitions/editgroup"
- <<: *ENTITYRESPONSES
- <<: *AUTHRESPONSES
- /file/{ident}:
- parameters:
- - name: ident
- in: path
- type: string
- required: true
- get:
- operationId: "get_file"
- tags: # TAGLINE
- - files # TAGLINE
- parameters:
- - name: expand
- in: query
- type: string
- required: false
- description: "List of sub-entities to expand in response. For files, `releases` is accepted."
- - name: hide
- in: query
- type: string
- required: false
- description: "List of entity fields to elide in response. For files, none accepted (yet)."
- responses:
- 200:
- description: Found Entity
- schema:
- $ref: "#/definitions/file_entity"
- <<: *ENTITYRESPONSES
- /editgroup/{editgroup_id}/file/{ident}:
- parameters:
- - name: editgroup_id
- in: path
- type: string
- required: true
- - name: ident
- in: path
- type: string
- required: true
- put:
- operationId: "update_file"
- tags: # TAGLINE
- - files # TAGLINE
- parameters:
- - name: entity
- in: body
- required: true
- schema:
- $ref: "#/definitions/file_entity"
- security:
- - Bearer: []
- responses:
- 200:
- description: Updated Entity
- schema:
- $ref: "#/definitions/entity_edit"
- <<: *ENTITYRESPONSES
- <<: *AUTHRESPONSES
- delete:
- operationId: "delete_file"
- tags: # TAGLINE
- - files # TAGLINE
- security:
- - Bearer: []
- responses:
- 200:
- description: Deleted Entity
- schema:
- $ref: "#/definitions/entity_edit"
- <<: *ENTITYRESPONSES
- <<: *AUTHRESPONSES
- /file/rev/{rev_id}:
- parameters:
- - name: rev_id
- in: path
- required: true
- <<: *FATCATUUID
- get:
- operationId: "get_file_revision"
- tags: # TAGLINE
- - files # TAGLINE
- parameters:
- - name: expand
- in: query
- type: string
- required: false
- description: "List of sub-entities to expand in response. See `get_file`."
- - name: hide
- in: query
- type: string
- required: false
- description: "List of entity fields to elide in response. See `get_file`."
- responses:
- 200:
- description: Found Entity Revision
- schema:
- $ref: "#/definitions/file_entity"
- <<: *ENTITYRESPONSES
- /file/{ident}/history:
- parameters:
- - name: ident
- in: path
- type: string
- required: true
- - name: limit
- in: query
- type: integer
- format: int64
- required: false
- get:
- operationId: "get_file_history"
- tags: # TAGLINE
- - files # TAGLINE
- responses:
- 200:
- description: Found Entity History
- schema:
- type: array
- items:
- $ref: "#/definitions/entity_history_entry"
- <<: *ENTITYRESPONSES
- /file/{ident}/redirects:
- parameters:
- - name: ident
- in: path
- type: string
- required: true
- get:
- operationId: "get_file_redirects"
- tags: # TAGLINE
- - files # TAGLINE
- responses:
- 200:
- description: Found Entity Redirects
- schema:
- type: array
- items:
- <<: *FATCATIDENT
- <<: *ENTITYRESPONSES
- /file/lookup:
- get:
- operationId: "lookup_file"
- tags: # TAGLINE
- - files # TAGLINE
- parameters:
- - name: md5
- in: query
- required: false
- <<: *FATCATMD5
- - name: sha1
- in: query
- required: false
- <<: *FATCATSHA1
- - name: sha256
- in: query
- required: false
- <<: *FATCATSHA256
- - name: expand
- in: query
- type: string
- required: false
- description: "List of sub-entities to expand in response. See `get_file`."
- - name: hide
- in: query
- type: string
- required: false
- description: "List of entity fields to elide in response. See `get_file`."
- responses:
- 200:
- description: Found Entity
- schema:
- $ref: "#/definitions/file_entity"
- <<: *ENTITYRESPONSES
- /file/edit/{edit_id}:
- get:
- operationId: "get_file_edit"
- tags: # TAGLINE
- - files # TAGLINE
- parameters:
- - name: edit_id
- in: path
- required: true
- <<: *FATCATUUID
- responses:
- 200:
- description: Found Edit
- schema:
- $ref: "#/definitions/entity_edit"
- <<: *ENTITYRESPONSES
- /editgroup/{editgroup_id}/file/edit/{edit_id}:
- parameters:
- - name: editgroup_id
- in: path
- required: true
- type: string
- - name: edit_id
- in: path
- required: true
- <<: *FATCATUUID
- delete:
- operationId: "delete_file_edit"
- tags: # TAGLINE
- - files # TAGLINE
- security:
- - Bearer: []
- responses:
- 200:
- description: Deleted Edit
- schema:
- $ref: "#/definitions/success"
- <<: *ENTITYRESPONSES
- <<: *AUTHRESPONSES
-
- /editgroup/{editgroup_id}/fileset:
- parameters:
- - name: editgroup_id
- in: path
- type: string
- required: true
- post:
- operationId: "create_fileset"
- tags: # TAGLINE
- - filesets # TAGLINE
- parameters:
- - name: entity
- in: body
- required: true
- schema:
- $ref: "#/definitions/fileset_entity"
- security:
- - Bearer: []
- responses:
- 201:
- description: Created Entity
- schema:
- $ref: "#/definitions/entity_edit"
- <<: *ENTITYRESPONSES
- <<: *AUTHRESPONSES
- /editgroup/auto/fileset/batch:
- post:
- operationId: "create_fileset_auto_batch"
- tags: # TAGLINE
- - filesets # TAGLINE
- parameters:
- - name: auto_batch
- in: body
- required: true
- schema:
- $ref: "#/definitions/fileset_auto_batch"
- security:
- - Bearer: []
- responses:
- 201:
- description: Created Editgroup
- schema:
- $ref: "#/definitions/editgroup"
- <<: *ENTITYRESPONSES
- <<: *AUTHRESPONSES
- /fileset/{ident}:
- parameters:
- - name: ident
- in: path
- type: string
- required: true
- get:
- operationId: "get_fileset"
- tags: # TAGLINE
- - filesets # TAGLINE
- parameters:
- - name: expand
- in: query
- type: string
- required: false
- description: "List of sub-entities to expand in response. For filesets, `releases` is accepted."
- - name: hide
- in: query
- type: string
- required: false
- description: "List of entity fields to elide in response. For filesets, 'manifest' is accepted."
- responses:
- 200:
- description: Found Entity
- schema:
- $ref: "#/definitions/fileset_entity"
- <<: *ENTITYRESPONSES
- /editgroup/{editgroup_id}/fileset/{ident}:
- parameters:
- - name: editgroup_id
- in: path
- type: string
- required: true
- - name: ident
- in: path
- type: string
- required: true
- put:
- operationId: "update_fileset"
- tags: # TAGLINE
- - filesets # TAGLINE
- parameters:
- - name: entity
- in: body
- required: true
- schema:
- $ref: "#/definitions/fileset_entity"
- security:
- - Bearer: []
- responses:
- 200:
- description: Updated Entity
- schema:
- $ref: "#/definitions/entity_edit"
- <<: *ENTITYRESPONSES
- <<: *AUTHRESPONSES
- delete:
- operationId: "delete_fileset"
- tags: # TAGLINE
- - filesets # TAGLINE
- security:
- - Bearer: []
- responses:
- 200:
- description: Deleted Entity
- schema:
- $ref: "#/definitions/entity_edit"
- <<: *ENTITYRESPONSES
- <<: *AUTHRESPONSES
- /fileset/rev/{rev_id}:
- parameters:
- - name: rev_id
- in: path
- required: true
- <<: *FATCATUUID
- get:
- operationId: "get_fileset_revision"
- tags: # TAGLINE
- - filesets # TAGLINE
- parameters:
- - name: expand
- in: query
- type: string
- required: false
- description: "List of sub-entities to expand in response. See `get_fileset`."
- - name: hide
- in: query
- type: string
- required: false
- description: "List of entity fields to elide in response. See `get_fileset`."
- responses:
- 200:
- description: Found Entity Revision
- schema:
- $ref: "#/definitions/fileset_entity"
- <<: *ENTITYRESPONSES
- /fileset/{ident}/history:
- parameters:
- - name: ident
- in: path
- type: string
- required: true
- - name: limit
- in: query
- type: integer
- format: int64
- required: false
- get:
- operationId: "get_fileset_history"
- tags: # TAGLINE
- - filesets # TAGLINE
- responses:
- 200:
- description: Found Entity History
- schema:
- type: array
- items:
- $ref: "#/definitions/entity_history_entry"
- <<: *ENTITYRESPONSES
- /fileset/{ident}/redirects:
- parameters:
- - name: ident
- in: path
- type: string
- required: true
- get:
- operationId: "get_fileset_redirects"
- tags: # TAGLINE
- - filesets # TAGLINE
- responses:
- 200:
- description: Found Entity Redirects
- schema:
- type: array
- items:
- <<: *FATCATIDENT
- <<: *ENTITYRESPONSES
- /fileset/edit/{edit_id}:
- get:
- operationId: "get_fileset_edit"
- tags: # TAGLINE
- - filesets # TAGLINE
- parameters:
- - name: edit_id
- in: path
- required: true
- <<: *FATCATUUID
- responses:
- 200:
- description: Found Edit
- schema:
- $ref: "#/definitions/entity_edit"
- <<: *ENTITYRESPONSES
- /editgroup/{editgroup_id}/fileset/edit/{edit_id}:
- parameters:
- - name: editgroup_id
- in: path
- required: true
- type: string
- - name: edit_id
- in: path
- required: true
- <<: *FATCATUUID
- delete:
- operationId: "delete_fileset_edit"
- tags: # TAGLINE
- - filesets # TAGLINE
- security:
- - Bearer: []
- responses:
- 200:
- description: Deleted Edit
- schema:
- $ref: "#/definitions/success"
- <<: *ENTITYRESPONSES
- <<: *AUTHRESPONSES
-
- /editgroup/{editgroup_id}/webcapture:
- parameters:
- - name: editgroup_id
- in: path
- type: string
- required: true
- post:
- operationId: "create_webcapture"
- tags: # TAGLINE
- - webcaptures # TAGLINE
- parameters:
- - name: entity
- in: body
- required: true
- schema:
- $ref: "#/definitions/webcapture_entity"
- security:
- - Bearer: []
- responses:
- 201:
- description: Created Entity
- schema:
- $ref: "#/definitions/entity_edit"
- <<: *ENTITYRESPONSES
- <<: *AUTHRESPONSES
- /editgroup/auto/webcapture/batch:
- post:
- operationId: "create_webcapture_auto_batch"
- tags: # TAGLINE
- - webcaptures # TAGLINE
- parameters:
- - name: auto_batch
- in: body
- required: true
- schema:
- $ref: "#/definitions/webcapture_auto_batch"
- security:
- - Bearer: []
- responses:
- 201:
- description: Created Editgroup
- schema:
- $ref: "#/definitions/editgroup"
- <<: *ENTITYRESPONSES
- <<: *AUTHRESPONSES
- /webcapture/{ident}:
- parameters:
- - name: ident
- in: path
- type: string
- required: true
- get:
- operationId: "get_webcapture"
- tags: # TAGLINE
- - webcaptures # TAGLINE
- parameters:
- - name: expand
- in: query
- type: string
- required: false
- description: "List of sub-entities to expand in response. For webcaptures, `releases` is accepted."
- - name: hide
- in: query
- type: string
- required: false
- description: "List of entity fields to elide in response. For webcaptures, 'cdx' is accepted."
- responses:
- 200:
- description: Found Entity
- schema:
- $ref: "#/definitions/webcapture_entity"
- <<: *ENTITYRESPONSES
- /editgroup/{editgroup_id}/webcapture/{ident}:
- parameters:
- - name: editgroup_id
- in: path
- type: string
- required: true
- - name: ident
- in: path
- type: string
- required: true
- put:
- operationId: "update_webcapture"
- tags: # TAGLINE
- - webcaptures # TAGLINE
- parameters:
- - name: entity
- in: body
- required: true
- schema:
- $ref: "#/definitions/webcapture_entity"
- security:
- - Bearer: []
- responses:
- 200:
- description: Updated Entity
- schema:
- $ref: "#/definitions/entity_edit"
- <<: *ENTITYRESPONSES
- <<: *AUTHRESPONSES
- delete:
- operationId: "delete_webcapture"
- tags: # TAGLINE
- - webcaptures # TAGLINE
- security:
- - Bearer: []
- responses:
- 200:
- description: Deleted Entity
- schema:
- $ref: "#/definitions/entity_edit"
- <<: *ENTITYRESPONSES
- <<: *AUTHRESPONSES
- /webcapture/rev/{rev_id}:
- parameters:
- - name: rev_id
- in: path
- required: true
- <<: *FATCATUUID
- get:
- operationId: "get_webcapture_revision"
- tags: # TAGLINE
- - webcaptures # TAGLINE
- parameters:
- - name: expand
- in: query
- type: string
- required: false
- description: "List of sub-entities to expand in response. See `get_webcapture`."
- - name: hide
- in: query
- type: string
- required: false
- description: "List of entity fields to elide in response. See `get_webcapture`."
- responses:
- 200:
- description: Found Entity Revision
- schema:
- $ref: "#/definitions/webcapture_entity"
- <<: *ENTITYRESPONSES
- /webcapture/{ident}/history:
- parameters:
- - name: ident
- in: path
- type: string
- required: true
- - name: limit
- in: query
- type: integer
- format: int64
- required: false
- get:
- operationId: "get_webcapture_history"
- tags: # TAGLINE
- - webcaptures # TAGLINE
- responses:
- 200:
- description: Found Entity History
- schema:
- type: array
- items:
- $ref: "#/definitions/entity_history_entry"
- <<: *ENTITYRESPONSES
- /webcapture/{ident}/redirects:
- parameters:
- - name: ident
- in: path
- type: string
- required: true
- get:
- operationId: "get_webcapture_redirects"
- tags: # TAGLINE
- - webcaptures # TAGLINE
- responses:
- 200:
- description: Found Entity Redirects
- schema:
- type: array
- items:
- <<: *FATCATIDENT
- <<: *ENTITYRESPONSES
- /webcapture/edit/{edit_id}:
- get:
- operationId: "get_webcapture_edit"
- tags: # TAGLINE
- - webcaptures # TAGLINE
- parameters:
- - name: edit_id
- in: path
- required: true
- <<: *FATCATUUID
- responses:
- 200:
- description: Found Edit
- schema:
- $ref: "#/definitions/entity_edit"
- <<: *ENTITYRESPONSES
- /editgroup/{editgroup_id}/webcapture/edit/{edit_id}:
- parameters:
- - name: editgroup_id
- in: path
- required: true
- type: string
- - name: edit_id
- in: path
- required: true
- <<: *FATCATUUID
- delete:
- operationId: "delete_webcapture_edit"
- tags: # TAGLINE
- - webcaptures # TAGLINE
- security:
- - Bearer: []
- responses:
- 200:
- description: Deleted Edit
- schema:
- $ref: "#/definitions/success"
- <<: *ENTITYRESPONSES
- <<: *AUTHRESPONSES
-
- /editgroup/{editgroup_id}/release:
- parameters:
- - name: editgroup_id
- in: path
- type: string
- required: true
- post:
- operationId: "create_release"
- tags: # TAGLINE
- - releases # TAGLINE
- description: |
- Create a single Release entity as part of an existing editgroup. If the
- `work_id` field is not set, a work entity will be created automatically
- and this field set pointing to the new work.
-
- Editgroup must be mutable (aka, not accepted) and editor must have
- permission (aka, have created the editgrou p or have `admin` role).
- parameters:
- - name: entity
- in: body
- required: true
- schema:
- $ref: "#/definitions/release_entity"
- security:
- - Bearer: []
- responses:
- 201:
- description: Created Entity
- schema:
- $ref: "#/definitions/entity_edit"
- <<: *ENTITYRESPONSES
- <<: *AUTHRESPONSES
- /editgroup/auto/release/batch:
- post:
- operationId: "create_release_auto_batch"
- tags: # TAGLINE
- - releases # TAGLINE
- description: |
- Create a set of Release entities as part of a new editgroup, and
- accept that editgroup in the same atomic request.
-
- This method is mostly useful for bulk import of new entities by
- carefully written bots. This method is more efficient than creating an
- editgroup, several entities, then accepting the editgroup, both in
- terms of API requests required and database load. Requires `admin`
- role.
- parameters:
- - name: auto_batch
- in: body
- required: true
- schema:
- $ref: "#/definitions/release_auto_batch"
- security:
- - Bearer: []
- responses:
- 201:
- description: Created Editgroup
- schema:
- $ref: "#/definitions/editgroup"
- <<: *ENTITYRESPONSES
- <<: *AUTHRESPONSES
- /release/{ident}:
- parameters:
- - name: ident
- in: path
- type: string
- required: true
- get:
- operationId: "get_release"
- tags: # TAGLINE
- - releases # TAGLINE
- description: |
- Fetches a single Release entity from the catalog.
- parameters:
- - name: expand
- in: query
- type: string
- required: false
- description: |
- List of sub-entities to expand in response. For releases, 'files',
- 'filesets, 'webcaptures', 'container', and 'creators' are valid.
- - name: hide
- in: query
- type: string
- required: false
- description: |
- List of entity fields to elide in response (for efficiency). For
- releases, 'abstracts', 'refs', and 'contribs' are valid.
- responses:
- 200:
- description: Found Entity
- schema:
- $ref: "#/definitions/release_entity"
- <<: *ENTITYRESPONSES
- /editgroup/{editgroup_id}/release/{ident}:
- parameters:
- - name: editgroup_id
- in: path
- type: string
- required: true
- - name: ident
- in: path
- type: string
- required: true
- put:
- operationId: "update_release"
- tags: # TAGLINE
- - releases # TAGLINE
- description: |
- Updates an existing entity as part of a specific (existing) editgroup.
- The editgroup must be open for updates (aka, not accepted/merged), and
- the editor making the requiest must have permissions (aka, must have
- created the editgroup or have `admin` role).
-
- This method can also be used to update an existing entity edit as part
- of an editgroup. For example, if an entity was created in this
- editgroup, an editor could make changes to the new entity's metadata
- before merging.
- parameters:
- - name: entity
- in: body
- required: true
- schema:
- $ref: "#/definitions/release_entity"
- security:
- - Bearer: []
- responses:
- 200:
- description: Updated Entity
- schema:
- $ref: "#/definitions/entity_edit"
- <<: *ENTITYRESPONSES
- <<: *AUTHRESPONSES
- delete:
- operationId: "delete_release"
- tags: # TAGLINE
- - releases # TAGLINE
- description: |
- Creates a new "deletion" edit for a specific entity as part of an
- existing editgroup.
-
- This is not the method to use to remove an edit from an editgroup; for
- that use `delete_release_edit`.
- security:
- - Bearer: []
- responses:
- 200:
- description: Deleted Entity
- schema:
- $ref: "#/definitions/entity_edit"
- <<: *ENTITYRESPONSES
- <<: *AUTHRESPONSES
- /release/rev/{rev_id}:
- parameters:
- - name: rev_id
- in: path
- required: true
- <<: *FATCATUUID
- get:
- operationId: "get_release_revision"
- tags: # TAGLINE
- - releases # TAGLINE
- description: |
- Fetches a specific entity revision. Note that the returned revision
- will not be associated with any particular fatcat identifier (even if
- one or more identifiers do currently point to this revision). The
- revision may even be part of an un-merged editgroup.
-
- Revisions are immutable and can not be deleted or updated.
- parameters:
- - name: expand
- in: query
- type: string
- required: false
- description:
- List of sub-entities to expand in response. See `get_release`,
- though note that identifier-based exapansions like `file` will
- always be empty for revisions.
- - name: hide
- in: query
- type: string
- required: false
- description: "List of entity fields to elide in response. See `get_release`."
- responses:
- 200:
- description: Found Entity Revision
- schema:
- $ref: "#/definitions/release_entity"
- <<: *ENTITYRESPONSES
- /release/{ident}/history:
- parameters:
- - name: ident
- in: path
- type: string
- required: true
- - name: limit
- in: query
- type: integer
- format: int64
- required: false
- get:
- operationId: "get_release_history"
- tags: # TAGLINE
- - releases # TAGLINE
- description: |
- Fetches the history of accepted edits (changelog entries) for a
- specific entity fatcat identifier.
- responses:
- 200:
- description: Found Entity History
- schema:
- type: array
- items:
- $ref: "#/definitions/entity_history_entry"
- <<: *ENTITYRESPONSES
- /release/{ident}/files:
- parameters:
- - name: ident
- in: path
- type: string
- required: true
- - name: hide
- in: query
- type: string
- required: false
- description: "List of entity fields to elide in response. See `get_file`."
- get:
- operationId: "get_release_files"
- tags: # TAGLINE
- - releases # TAGLINE
- description: |
- Returns the set of File entities that have a `release_id` pointing to
- this release entity.
- responses:
- 200:
- description: Found
- schema:
- type: array
- items:
- $ref: "#/definitions/file_entity"
- <<: *ENTITYRESPONSES
- /release/{ident}/filesets:
- parameters:
- - name: ident
- in: path
- type: string
- required: true
- - name: hide
- in: query
- type: string
- required: false
- description: "List of entity fields to elide in response. See `get_fileset`."
- get:
- operationId: "get_release_filesets"
- tags: # TAGLINE
- - releases # TAGLINE
- description: |
- Returns the set of Fileset entities that have a `release_id` pointing to
- this release entity.
- responses:
- 200:
- description: Found
- schema:
- type: array
- items:
- $ref: "#/definitions/fileset_entity"
- <<: *ENTITYRESPONSES
- /release/{ident}/webcaptures:
- parameters:
- - name: ident
- in: path
- type: string
- required: true
- - name: hide
- in: query
- type: string
- required: false
- description: "List of entity fields to elide in response. See `get_webcapture`."
- get:
- operationId: "get_release_webcaptures"
- tags: # TAGLINE
- - releases # TAGLINE
- description: |
- Returns the set of Web Capture entities that have a `release_id`
- pointing to this release entity.
- responses:
- 200:
- description: Found
- schema:
- type: array
- items:
- $ref: "#/definitions/webcapture_entity"
- <<: *ENTITYRESPONSES
- /release/{ident}/redirects:
- parameters:
- - name: ident
- in: path
- type: string
- required: true
- get:
- operationId: "get_release_redirects"
- tags: # TAGLINE
- - releases # TAGLINE
- description: |
- Returns the set of entity identifiers which currently redirect to this
- identifier.
- responses:
- 200:
- description: Found Entity Redirects
- schema:
- type: array
- items:
- <<: *FATCATIDENT
- <<: *ENTITYRESPONSES
- /release/lookup:
- get:
- operationId: "lookup_release"
- tags: # TAGLINE
- - releases # TAGLINE
- description: |
- Looks for an active entity with the given external identifier. If any
- such entity is found, returns a single complete entity. If multiple
- entities have the same external identifier, this is considered a soft
- catalog error, and the behavior of which entity is returned is
- undefined.
-
- One (and only one) external identifier should be specified per request.
- parameters:
- # TODO: use identifier types here
- - name: doi
- in: query
- type: string
- required: false
- - name: wikidata_qid
- in: query
- type: string
- required: false
- - name: isbn13
- in: query
- type: string
- required: false
- - name: pmid
- in: query
- type: string
- required: false
- - name: pmcid
- in: query
- type: string
- required: false
- - name: core
- in: query
- type: string
- required: false
- - name: arxiv
- in: query
- type: string
- required: false
- - name: jstor
- in: query
- type: string
- required: false
- - name: ark
- in: query
- type: string
- required: false
- - name: mag
- in: query
- type: string
- required: false
- - name: expand
- in: query
- type: string
- required: false
- description: "List of sub-entities to expand in response. See `get_release`."
- - name: hide
- in: query
- type: string
- required: false
- description: "List of sub-entities to elide in response. See `get_release`."
- responses:
- 200:
- description: Found Entity
- schema:
- $ref: "#/definitions/release_entity"
- <<: *ENTITYRESPONSES
- /release/edit/{edit_id}:
- get:
- operationId: "get_release_edit"
- tags: # TAGLINE
- - releases # TAGLINE
- description: |
- Returns the entity edit object with the given identifier. This method
- is expected to be used rarely.
- parameters:
- - name: edit_id
- in: path
- required: true
- <<: *FATCATUUID
- responses:
- 200:
- description: Found Edit
- schema:
- $ref: "#/definitions/entity_edit"
- <<: *ENTITYRESPONSES
- /editgroup/{editgroup_id}/release/edit/{edit_id}:
- parameters:
- - name: editgroup_id
- in: path
- required: true
- type: string
- - name: edit_id
- in: path
- required: true
- <<: *FATCATUUID
- delete:
- operationId: "delete_release_edit"
- tags: # TAGLINE
- - releases # TAGLINE
- description: |
- Removes a single edit from the specified editgroup. The editgroup must
- be mutable (aka, not accepted/merged), and the editor making this
- request must have permission (aka, have created the editgroup or hold
- the `admin` role).
-
- Not to be confused with the `delete_container` method, which *creates*
- a new edit in the given editgroup.
- security:
- - Bearer: []
- responses:
- 200:
- description: Deleted Edit
- schema:
- $ref: "#/definitions/success"
- <<: *ENTITYRESPONSES
- <<: *AUTHRESPONSES
-
- /editgroup/{editgroup_id}/work:
- parameters:
- - name: editgroup_id
- in: path
- type: string
- required: true
- post:
- operationId: "create_work"
- tags: # TAGLINE
- - works # TAGLINE
- parameters:
- - name: entity
- in: body
- required: true
- schema:
- $ref: "#/definitions/work_entity"
- security:
- - Bearer: []
- responses:
- 201:
- description: Created Entity
- schema:
- $ref: "#/definitions/entity_edit"
- <<: *ENTITYRESPONSES
- <<: *AUTHRESPONSES
- /editgroup/auto/work/batch:
- post:
- operationId: "create_work_auto_batch"
- tags: # TAGLINE
- - works # TAGLINE
- parameters:
- - name: auto_batch
- in: body
- required: true
- schema:
- $ref: "#/definitions/work_auto_batch"
- security:
- - Bearer: []
- responses:
- 201:
- description: Created Editgroup
- schema:
- $ref: "#/definitions/editgroup"
- <<: *ENTITYRESPONSES
- <<: *AUTHRESPONSES
- /work/{ident}:
- parameters:
- - name: ident
- in: path
- type: string
- required: true
- get:
- operationId: "get_work"
- tags: # TAGLINE
- - works # TAGLINE
- parameters:
- - name: expand
- in: query
- type: string
- required: false
- description: "List of sub-entities to expand in response. For works, none accepted (yet)."
- - name: hide
- in: query
- type: string
- required: false
- description: "List of entity fields to elide in response. For works, none accepted (yet)."
- responses:
- 200:
- description: Found Entity
- schema:
- $ref: "#/definitions/work_entity"
- <<: *ENTITYRESPONSES
- /editgroup/{editgroup_id}/work/{ident}:
- parameters:
- - name: editgroup_id
- in: path
- type: string
- required: true
- - name: ident
- in: path
- type: string
- required: true
- put:
- operationId: "update_work"
- tags: # TAGLINE
- - works # TAGLINE
- parameters:
- - name: entity
- in: body
- required: true
- schema:
- $ref: "#/definitions/work_entity"
- security:
- - Bearer: []
- responses:
- 200:
- description: Updated Entity
- schema:
- $ref: "#/definitions/entity_edit"
- <<: *ENTITYRESPONSES
- <<: *AUTHRESPONSES
- delete:
- operationId: "delete_work"
- tags: # TAGLINE
- - works # TAGLINE
- security:
- - Bearer: []
- responses:
- 200:
- description: Deleted Entity
- schema:
- $ref: "#/definitions/entity_edit"
- <<: *ENTITYRESPONSES
- <<: *AUTHRESPONSES
- /work/rev/{rev_id}:
- parameters:
- - name: rev_id
- in: path
- required: true
- <<: *FATCATUUID
- get:
- operationId: "get_work_revision"
- tags: # TAGLINE
- - works # TAGLINE
- parameters:
- - name: expand
- in: query
- type: string
- required: false
- description:
- List of sub-entities to expand in response. See `get_work`, though
- note that identifier-based expansions like `releases` will always
- be empty for revisions.
- - name: hide
- in: query
- type: string
- required: false
- description: "List of entity fields to elide in response. See `get_work`."
- responses:
- 200:
- description: Found Entity Revision
- schema:
- $ref: "#/definitions/work_entity"
- <<: *ENTITYRESPONSES
- /work/{ident}/history:
- parameters:
- - name: ident
- in: path
- type: string
- required: true
- - name: limit
- in: query
- type: integer
- format: int64
- required: false
- get:
- operationId: "get_work_history"
- tags: # TAGLINE
- - works # TAGLINE
- responses:
- 200:
- description: Found Entity History
- schema:
- type: array
- items:
- $ref: "#/definitions/entity_history_entry"
- <<: *ENTITYRESPONSES
- /work/{ident}/redirects:
- parameters:
- - name: ident
- in: path
- type: string
- required: true
- get:
- operationId: "get_work_redirects"
- tags: # TAGLINE
- - works # TAGLINE
- responses:
- 200:
- description: Found Entity Redirects
- schema:
- type: array
- items:
- <<: *FATCATIDENT
- <<: *ENTITYRESPONSES
- /work/{ident}/releases:
- parameters:
- - name: ident
- in: path
- type: string
- required: true
- - name: hide
- in: query
- type: string
- required: false
- description: "List of entity fields to elide in response. See `get_release`."
- get:
- operationId: "get_work_releases"
- tags: # TAGLINE
- - works # TAGLINE
- description: |
- Returns the set of release entities that are part of this work (aka,
- have `work_id` pointing to this work entity).
- responses:
- 200:
- description: Found
- schema:
- type: array
- items:
- $ref: "#/definitions/release_entity"
- <<: *ENTITYRESPONSES
- /work/edit/{edit_id}:
- get:
- operationId: "get_work_edit"
- tags: # TAGLINE
- - works # TAGLINE
- parameters:
- - name: edit_id
- in: path
- required: true
- <<: *FATCATUUID
- responses:
- 200:
- description: Found Edit
- schema:
- $ref: "#/definitions/entity_edit"
- <<: *ENTITYRESPONSES
- /editgroup/{editgroup_id}/work/edit/{edit_id}:
- parameters:
- - name: editgroup_id
- in: path
- required: true
- type: string
- - name: edit_id
- in: path
- required: true
- <<: *FATCATUUID
- delete:
- operationId: "delete_work_edit"
- tags: # TAGLINE
- - works # TAGLINE
- security:
- - Bearer: []
- responses:
- 200:
- description: Deleted Edit
- schema:
- $ref: "#/definitions/success"
- <<: *ENTITYRESPONSES
- <<: *AUTHRESPONSES
-
- /editor/{editor_id}:
- parameters:
- - name: editor_id
- in: path
- type: string
- required: true
- get:
- operationId: "get_editor"
- tags: # TAGLINE
- - editors # TAGLINE
- description: |
- Returns an editor object, including metadata such as the username,
- type, and role of editor.
- responses:
- 200:
- description: Found
- schema:
- $ref: "#/definitions/editor"
- 400:
- description: Bad Request
- schema:
- $ref: "#/definitions/error_response"
- 404:
- description: Not Found
- schema:
- $ref: "#/definitions/error_response"
- 500:
- description: Generic Error
- schema:
- $ref: "#/definitions/error_response"
- put:
- operationId: "update_editor"
- tags: # TAGLINE
- - editors # TAGLINE
- description: |
- Allows metadata changes to some editor fields, such as the username.
-
- Changes require authentication and permissions. An editor can change
- their own username; changes to role flags require the `admin` role by
- the editor making the request.
- parameters:
- - name: editor
- in: body
- required: true
- schema:
- $ref: "#/definitions/editor"
- security:
- - Bearer: []
- responses:
- 200:
- description: Updated Editor
- schema:
- $ref: "#/definitions/editor"
- 400:
- description: Bad Request
- schema:
- $ref: "#/definitions/error_response"
- 404:
- description: Not Found
- schema:
- $ref: "#/definitions/error_response"
- 500:
- description: Generic Error
- schema:
- $ref: "#/definitions/error_response"
- <<: *AUTHRESPONSES
- /editor/{editor_id}/editgroups:
- parameters:
- - name: editor_id
- in: path
- type: string
- required: true
- get:
- operationId: "get_editor_editgroups"
- tags: # TAGLINE
- - editors # TAGLINE
- description: |
- Returns a set of editgroups created by the given editor, regardless of
- the status (accepted/submitted) of the editgroups.
- parameters:
- - name: limit
- in: query
- type: integer
- format: int64
- required: false
- - name: before
- in: query
- type: string
- format: date-time
- required: false
- description: |
- Return only editgroups created *before* the given timestamp (not
- inclusive). Editgroups will be sorted by creation time in
- descending order (most recent first). For use in pagination.
- - name: since
- in: query
- type: string
- format: date-time
- required: false
- description: |
- Return only editgroups created *after* the given timestamp (not
- inclusive). Editgroups will be sorted by creation time in ascending
- order (most recent last). For use in pagination.
- responses:
- 200:
- description: Found
- schema:
- type: array
- items:
- $ref: "#/definitions/editgroup"
- 400:
- description: Bad Request
- schema:
- $ref: "#/definitions/error_response"
- 404:
- description: Not Found
- schema:
- $ref: "#/definitions/error_response"
- 500:
- description: Generic Error
- schema:
- $ref: "#/definitions/error_response"
- /editor/{editor_id}/annotations:
- parameters:
- - name: editor_id
- in: path
- required: true
- <<: *FATCATIDENT
- get:
- operationId: "get_editor_annotations"
- tags: # TAGLINE
- - editors # TAGLINE
- description: |
- Fetches a list of annotations made by a particular editor.
- parameters:
- - name: limit
- in: query
- type: integer
- format: int64
- required: false
- description: "Maximum number (count) of annotations to return in response"
- - name: before
- in: query
- type: string
- format: date-time
- required: false
- description: |
- Return only annotations made *before* the given timestamp (not
- inclusive). Annotations will be sorted by creation time in
- descending order (most recent first). For use in pagination.
- - name: since
- in: query
- type: string
- format: date-time
- required: false
- description: |
- Return only annotations made *after* the given timestamp (not
- inclusive). Annotations will be sorted by creation time in
- ascending order (most recent last). For use in pagination.
- responses:
- 200:
- description: Success
- schema:
- type: array
- items:
- $ref: "#/definitions/editgroup_annotation"
- 400:
- description: Bad Request
- schema:
- $ref: "#/definitions/error_response"
- 404:
- description: Not Found
- schema:
- $ref: "#/definitions/error_response"
- 500:
- description: Generic Error
- schema:
- $ref: "#/definitions/error_response"
- <<: *AUTHRESPONSES
-
- /editgroup:
- post:
- operationId: "create_editgroup"
- tags: # TAGLINE
- - editgroups # TAGLINE
- description: |
- Creates a new editgroup. By default the editor making this request will
- be the author of the editgroup.
- parameters:
- - name: editgroup
- in: body
- required: true
- schema:
- $ref: "#/definitions/editgroup"
- security:
- - Bearer: []
- responses:
- 201:
- description: Successfully Created
- schema:
- $ref: "#/definitions/editgroup"
- 400:
- description: Bad Request
- schema:
- $ref: "#/definitions/error_response"
- 404: # added only for response type consistency
- description: Not Found
- schema:
- $ref: "#/definitions/error_response"
- 500:
- description: Generic Error
- schema:
- $ref: "#/definitions/error_response"
- <<: *AUTHRESPONSES
- /editgroup/{editgroup_id}:
- parameters:
- - name: editgroup_id
- in: path
- required: true
- <<: *FATCATIDENT
- get:
- operationId: "get_editgroup"
- tags: # TAGLINE
- - editgroups # TAGLINE
- description: |
- Returns a single editgroup object.
-
- Unlike some similar methods, this method will return a full/expanded
- editgroup object, which includes edit lists of each entity type (though
- will not include the complete entity objects).
- responses:
- 200:
- description: Found
- schema:
- $ref: "#/definitions/editgroup"
- 400:
- description: Bad Request
- schema:
- $ref: "#/definitions/error_response"
- 404:
- description: Not Found
- schema:
- $ref: "#/definitions/error_response"
- 500:
- description: Generic Error
- schema:
- $ref: "#/definitions/error_response"
- put:
- operationId: "update_editgroup"
- tags: # TAGLINE
- - editgroups # TAGLINE
- description: |
- Updates metadata for a single editgroup object. Note that only metadata
- fields such as the `description` or `extra` metadata can be changed
- with this method; it does not allow adding or removing edits to the
- editgroup (for that use the individual entity create/update/delete
- methods).
- security:
- - Bearer: []
- parameters:
- - name: editgroup
- in: body
- required: true
- schema:
- $ref: "#/definitions/editgroup"
- - name: submit
- in: query
- type: boolean
- required: false
- responses:
- 200:
- description: Updated Editgroup
- schema:
- $ref: "#/definitions/editgroup"
- 400:
- description: Bad Request
- schema:
- $ref: "#/definitions/error_response"
- 404:
- description: Not Found
- schema:
- $ref: "#/definitions/error_response"
- 500:
- description: Generic Error
- schema:
- $ref: "#/definitions/error_response"
- <<: *AUTHRESPONSES
- /editgroup/{editgroup_id}/accept:
- parameters:
- - name: editgroup_id
- in: path
- required: true
- <<: *FATCATIDENT
- post:
- operationId: "accept_editgroup"
- tags: # TAGLINE
- - editgroups # TAGLINE
- description: |
- Accept ("merge") the given editgroup into the catalog. The editgroup
- must be open (not already accepted), and the editor making this request
- must have the `admin` role.
- security:
- - Bearer: []
- responses:
- 200:
- description: Merged Successfully
- schema:
- $ref: "#/definitions/success"
- 400:
- description: Bad Request
- schema:
- $ref: "#/definitions/error_response"
- 404:
- description: Not Found
- schema:
- $ref: "#/definitions/error_response"
- 409:
- description: Edit Conflict
- schema:
- $ref: "#/definitions/error_response"
- 500:
- description: Generic Error
- schema:
- $ref: "#/definitions/error_response"
- <<: *AUTHRESPONSES
- /editgroup/{editgroup_id}/annotations:
- parameters:
- - name: editgroup_id
- in: path
- required: true
- <<: *FATCATIDENT
- get:
- operationId: "get_editgroup_annotations"
- tags: # TAGLINE
- - editgroups # TAGLINE
- description:
- Returns a list of annotations made to a specific editgroup.
- parameters:
- - name: expand
- in: query
- type: string
- required: false
- description: "List of sub-entities to expand in response. For editgroup annotations: 'editors'"
- responses:
- 200:
- description: Success
- schema:
- type: array
- items:
- $ref: "#/definitions/editgroup_annotation"
- 400:
- description: Bad Request
- schema:
- $ref: "#/definitions/error_response"
- 404:
- description: Not Found
- schema:
- $ref: "#/definitions/error_response"
- 500:
- description: Generic Error
- schema:
- $ref: "#/definitions/error_response"
- <<: *AUTHRESPONSES
- /editgroup/{editgroup_id}/annotation:
- parameters:
- - name: editgroup_id
- in: path
- required: true
- <<: *FATCATIDENT
- post:
- operationId: "create_editgroup_annotation"
- tags: # TAGLINE
- - editgroups # TAGLINE
- description: |
- Submits a new annotation to the specified editgroup.
-
- The editgroup must be open (not already accepted). The annotation will
- automatically have authorship of the editor making this request.
- security:
- - Bearer: []
- parameters:
- - name: annotation
- in: body
- required: true
- schema:
- $ref: "#/definitions/editgroup_annotation"
- responses:
- 201:
- description: Created
- schema:
- $ref: "#/definitions/editgroup_annotation"
- 400:
- description: Bad Request
- schema:
- $ref: "#/definitions/error_response"
- 404:
- description: Not Found
- schema:
- $ref: "#/definitions/error_response"
- 500:
- description: Generic Error
- schema:
- $ref: "#/definitions/error_response"
- <<: *AUTHRESPONSES
- /editgroup/reviewable:
- get:
- operationId: "get_editgroups_reviewable"
- tags: # TAGLINE
- - editgroups # TAGLINE
- description: |
- Returns a set of editgroups which have been submitted but not yet accepted.
-
- Query parameters can be used to sort and paginate the list returned.
- parameters:
- - name: expand
- in: query
- type: string
- required: false
- description: "List of sub-entities to expand in response. For editgroups: 'editors'"
- - name: limit
- in: query
- type: integer
- format: int64
- required: false
- description: "Maximum number of reviewable editgroups to return in response"
- - name: before
- in: query
- type: string
- format: date-time
- required: false
- description: |
- Return only reviewable editgroups submitted *before* the given
- timestamp (not inclusive). Editgroups will be sorted by submission
- time in descending order (most recent first). For use in pagination.
- - name: since
- in: query
- type: string
- format: date-time
- required: false
- description: |
- Return only reviewable editgroups submitted *after* the given
- timestamp (not inclusive). Editgroups will be sorted by submission
- time in ascending order (most recent last). For use in pagination.
- responses:
- 200:
- description: Found
- schema:
- type: array
- items:
- $ref: "#/definitions/editgroup"
- 400:
- description: Bad Request
- schema:
- $ref: "#/definitions/error_response"
- 404:
- description: Not Found
- schema:
- $ref: "#/definitions/error_response"
- 500:
- description: Generic Error
- schema:
- $ref: "#/definitions/error_response"
- /changelog:
- parameters:
- - name: limit
- in: query
- type: integer
- format: int64
- required: false
- description: "Maximum count of changelog entries to return in response"
- get:
- operationId: "get_changelog"
- tags: # TAGLINE
- - changelog # TAGLINE
- description: |
- Returns a list of the most recent changelog entries accepted (merged)
- into the catalog.
-
- List is sorted by changelog index in descending order. Note that the
- accepted timestamp roughly corresponds to order, but not strictly;
- there exist out-of-order timestamps on the order of several seconds.
-
- As a known database issue, it is technically possible for there to be a
- gap in changelog index numbers (aka, a missing changelog entry). There
- are no currently known gaps and this is considered a bug that will be
- addressed.
-
- There are millions of entries; to paginate through all of them, use
- this method to discover the highest existing entry number, then request
- the entries using `get_changelog_entry` one at a time.
- responses:
- 200:
- description: Success
- schema:
- type: array
- items:
- $ref: "#/definitions/changelog_entry"
- 400: # added only for response type consistency
- description: Bad Request
- schema:
- $ref: "#/definitions/error_response"
- 500:
- description: Generic Error
- schema:
- $ref: "#/definitions/error_response"
- /changelog/{index}:
- parameters:
- - name: index
- in: path
- type: integer
- format: int64
- required: true
- description: "Changelog index of entry to return"
- get:
- operationId: "get_changelog_entry"
- tags: # TAGLINE
- - changelog # TAGLINE
- description: |
- Returns a single changelog entry.
-
- As a known database issue, it is technically possible for there to be a
- gap in changelog index numbers (aka, a missing changelog entry). There
- are no currently known gaps and this is considered a bug that will be
- addressed.
- responses:
- 200:
- description: Found Changelog Entry
- schema:
- $ref: "#/definitions/changelog_entry"
- 400: # added only for response type consistency
- description: Bad Request
- schema:
- $ref: "#/definitions/error_response"
- 404:
- description: Not Found
- schema:
- $ref: "#/definitions/error_response"
- 500:
- description: Generic Error
- schema:
- $ref: "#/definitions/error_response"
- /auth/oidc:
- post:
- operationId: "auth_oidc"
- tags: # TAGLINE
- - auth # TAGLINE
- description: |
- Login or create editor account using OIDC metadata (internal method).
-
- This method is used by privileged front-end tools (like the web
- interface service) to process editor logins using OpenID Connect (OIDC)
- and/or OAuth. Most accounts (including tool and bot accounts) do not
- have sufficient privileges to call this method, which requires the
- `admin` role.
-
- The method returns an API token; the HTTP status code indicates whether
- an existing account was logged in, or a new account was created.
- security:
- # required admin privs
- - Bearer: []
- parameters:
- - name: oidc_params
- in: body
- required: true
- schema:
- $ref: "#/definitions/auth_oidc"
- responses:
- 200:
- description: Found
- schema:
- $ref: "#/definitions/auth_oidc_result"
- 201:
- description: Created
- schema:
- $ref: "#/definitions/auth_oidc_result"
- 400:
- description: Bad Request
- schema:
- $ref: "#/definitions/error_response"
- 409:
- description: Conflict
- schema:
- $ref: "#/definitions/error_response"
- 500:
- description: Generic Error
- schema:
- $ref: "#/definitions/error_response"
- <<: *AUTHRESPONSES
- /auth/check:
- get:
- operationId: "auth_check"
- tags: # TAGLINE
- - auth # TAGLINE
- description: |
- Verify that authentication (API token) is working as expected. The
- optional `role` parameter can be used to verify that the current
- account (editor) has permissions for the given role.
- security:
- # required admin privs
- - Bearer: []
- parameters:
- - name: role
- in: query
- required: false
- type: string
- responses:
- 200:
- description: Success
- schema:
- $ref: "#/definitions/success"
- 400:
- description: Bad Request
- schema:
- $ref: "#/definitions/error_response"
- 500:
- description: Generic Error
- schema:
- $ref: "#/definitions/error_response"
- <<: *AUTHRESPONSES
- /auth/token/{editor_id}:
- parameters:
- - name: editor_id
- in: path
- type: string
- required: true
- post:
- operationId: "create_auth_token"
- tags: # TAGLINE
- - auth # TAGLINE
- description: |
- Generate a new auth token for a given editor (internal method).
-
- This method is used by the web interface to generate API tokens for
- users. It can not be called by editors (human or bot) to generate new
- tokens for themselves, at least at this time.
- security:
- # required admin privs
- - Bearer: []
- parameters:
- - name: duration_seconds
- in: query
- type: integer
- example: 86400
- required: false
- description: "How long API token should be valid for (in seconds)"
- responses:
- 200:
- description: Success
- schema:
- $ref: "#/definitions/auth_token_result"
- 400:
- description: Bad Request
- schema:
- $ref: "#/definitions/error_response"
- 500:
- description: Generic Error
- schema:
- $ref: "#/definitions/error_response"
- <<: *AUTHRESPONSES
diff --git a/rust/fatcat-openapi/api/swagger.yaml b/rust/fatcat-openapi/api/swagger.yaml
deleted file mode 100644
index effedcda..00000000
--- a/rust/fatcat-openapi/api/swagger.yaml
+++ /dev/null
@@ -1,10325 +0,0 @@
----
-swagger: "2.0"
-info:
- description: "Fatcat is a scalable, versioned, API-oriented catalog of bibliographic\n\
- entities and file metadata.\n\n<!-- STARTLONGDESCRIPTION -->\nThese API reference\
- \ documents, along with client software libraries, are\ngenerated automatically\
- \ from an OpenAPI 2.0 (\"Swagger\") definition file.\n\n## Introduction\n\n\n\
- A higher-level introduction to the API, as well as a description of the\nfatcat\
- \ data model, are available in [\"The Fatcat Guide\"](https://guide.fatcat.wiki/).\n\
- The guide also includes a [Cookbook](https://guide.fatcat.wiki/cookbook.html)\n\
- section demonstrating end-to-end tasks like creating entities as part of\neditgroups,\
- \ or safely merging duplicate entities.\n\n### Expectations and Best Practices\n\
- \nA test/staging QA API instance of fatcat is available at\n<https://api.qa.fatcat.wiki/v0>.\
- \ The database backing this instance is\nseparate from the production interface,\
- \ and is periodically rebuilt from\nsnapshots of the full production database,\
- \ meaning that edits on the QA\nserver will *NOT* persist, and that semantics\
- \ like the changelog index\nmonotonically increasing *MAY* be broken. Developers\
- \ are expexcted to test\ntheir scripts and tools against the QA instance before\
- \ running against\nproduction.\n\nFatcat is made available as a gratis (no cost)\
- \ and libre (freedom\npreserving) service to the public, with limited funding\
- \ and resources. We\nwelcome new and unforseen uses and contributions, but may\
- \ need to impose\nrestrictions (like rate-limits) to keep the service functional\
- \ for other\nusers, and in extreme cases reserve the option to block accounts\
- \ and IP\nranges if necessary to keep the service operational.\n\nThe Internet\
- \ Archive owns and operates it's own server equipment and data\ncenters, and operations\
- \ are optimized for low-cost, not high-availability.\nUsers and partners should\
- \ expect some downtime on the fatcat API, on the\norder of hours a month.\n\n\
- Periodic metadata exports are available for batch processing, and database\nsnapshots\
- \ can be used to create locally-hosted mirrors of the service for\nmore intensive\
- \ and reliable querying.\n\n### Other Nitty Gritties\n\nCross-origin requests\
- \ are allowed for the API service, to enable third\nparties to bulid in-browser\
- \ applications.\n\nA metadata search service is available at <https://search.fatcat.wiki>\
- \ (and\n<https://search.qa.fatcat.wiki>). The API is currently the raw\nelasticsearch\
- \ API, with only GET (read) requests allowed. This public\nservice is experimental\
- \ and may be removed or limited in the future.\n\n## Authentication\n\nThe API\
- \ allows basic read-only \"GET\" HTTP requests with no authentication.\nProposing\
- \ changes to the metadata, or other mutating requests (\"PUT\",\n\"POST\", \"\
- DELETE\") all require authentication, and some operations require\nadditional\
- \ account permissions.\n\nEnd-user account creation and login happens through\
- \ the web interface. From\na logged-in editor profile page, you can generate a\
- \ API token. Tokens are\n\"macaroons\", similar to JWT tokens, and are used for\
- \ all API\nauthentication. The web interface includes macaroons in browser cookies\
- \ and\npasses them through to the API to authenticate editor actions.\n\n<!--\
- \ ReDoc-Inject: <security-definitions> -->\n<!-- ENDLONGDESCRIPTION -->\n"
- version: "0.3.1"
- title: "fatcat"
- termsOfService: "https://guide.fatcat.wiki/policies.html"
- contact:
- name: "Internet Archive Web Group"
- url: "https://fatcat.wiki"
- email: "webservices@archive.org"
- x-logo:
- url: "https://fatcat.wiki/static/paper_man_confused.gif"
- altText: "Confused Papers Man (Logo)"
- backgroundColor: "#FFFFFF"
-host: "api.fatcat.wiki"
-basePath: "/v0"
-tags:
-- name: "containers"
- description: "**Container** entities represent publication venues like journals,\
- \ # TAGLINE\nconference proceedings, book series, or blogs. They group publications\
- \ # TAGLINE\n(\"releases\"). # TAGLINE\n\nSee the \"Catalog Style Guide\" section\
- \ of the guide for details and # TAGLINE\nsemantics of what should be included\
- \ in specific entity fields. # TAGLINE\nSpecifically, the # TAGLINE\n[Container\
- \ Entity Reference](https://guide.fatcat.wiki/entity_container.html). # TAGLINE\n"
- x-displayName: "Containers"
-- name: "creators"
- description: "**Creator** entities represent individuals (or organizations, or other\
- \ # TAGLINE\nagents) who contribute to the creation of specific releases # TAGLINE\n\
- (publications). # TAGLINE\n\nSee the \"Catalog Style Guide\" section of the guide\
- \ for details and # TAGLINE\nsemantics of what should be included in specific\
- \ entity fields. # TAGLINE\nSpecifically, the # TAGLINE\n[Creator Entity Reference](https://guide.fatcat.wiki/entity_creator.html).\
- \ # TAGLINE\n"
- x-displayName: "Creators"
-- name: "files"
- description: "**File** entities represent unique digital files which are full #\
- \ TAGLINE\nmanifestations of specific releases (publications), such as fulltext\
- \ PDF # TAGLINE\nfiles, JATS XML documents, or video files. File entities also\
- \ include a # TAGLINE\nset of locations where they can be found on the public\
- \ web. # TAGLINE\n\nSee the \"Catalog Style Guide\" section of the guide for\
- \ details and # TAGLINE\nsemantics of what should be included in specific entity\
- \ fields. # TAGLINE\nSpecifically, the # TAGLINE\n[File Entity Reference](https://guide.fatcat.wiki/entity_file.html).\
- \ # TAGLINE\n"
- x-displayName: "Files"
-- name: "filesets"
- description: "**Fileset** entities represent sets of digital files, as well as locations\
- \ # TAGLINE\nwhere they can be found on the public web. Filesets most commonly\
- \ # TAGLINE\nrepresent datasets consisting of serveral data and metadata files.\
- \ # TAGLINE\n\nSee the \"Catalog Style Guide\" section of the guide for details\
- \ and # TAGLINE\nsemantics of what should be included in specific entity fields.\
- \ # TAGLINE\nSpecifically, the # TAGLINE\n[Fileset Entity Reference](https://guide.fatcat.wiki/entity_fileset.html).\
- \ # TAGLINE\n"
- x-displayName: "Filesets"
-- name: "webcaptures"
- description: "**Web Capture** entities represent archival snapshots of web pages\
- \ (or # TAGLINE\nother web resources), which are usually complete manifestations\
- \ of a # TAGLINE\nspecific release entity. Web Captures also include a set of\
- \ locations # TAGLINE\n(wayback replay instances or WARC files) where the capture\
- \ can be found. # TAGLINE\n\nSee the \"Catalog Style Guide\" section of the guide\
- \ for details and # TAGLINE\nsemantics of what should be included in specific\
- \ entity fields. # TAGLINE\nSpecifically, the # TAGLINE\n[Web Capture Entity\
- \ Reference](https://guide.fatcat.wiki/entity_webcapture.html). # TAGLINE\n"
- x-displayName: "Webcaptures"
-- name: "releases"
- description: "**Release** entities represent specific published versions of a research\
- \ # TAGLINE\nwork, such as a pre-print, a journal article, a book (or chapter),\
- \ or a # TAGLINE\nscholarly blog post. Releases are always grouped together under\
- \ Works; # TAGLINE\nthey may be published in a specific Container; they may have\
- \ known # TAGLINE\nCreators; and there may exist known File/Fileset/WebCapture\
- \ digital copies # TAGLINE\nof the release. # TAGLINE\n\nSee the \"Catalog Style\
- \ Guide\" section of the guide for details and # TAGLINE\nsemantics of what should\
- \ be included in specific entity fields. # TAGLINE\nSpecifically, the # TAGLINE\n\
- [Release Entity Reference](https://guide.fatcat.wiki/entity_release.html). #\
- \ TAGLINE\n"
- x-displayName: "Releases"
-- name: "works"
- description: "**Work** entities group several Release entities which are different\
- \ # TAGLINE\nversions of the same abstract piece of research. For example, three\
- \ # TAGLINE\nrelease entities representing the pre-print, published article,\
- \ and # TAGLINE\nretraction stages of the same journal paper would be grouped\
- \ under a # TAGLINE\nsingle work. # TAGLINE\n\nSee the \"Catalog Style Guide\"\
- \ section of the guide for details and # TAGLINE\nsemantics of what should be\
- \ included in specific entity fields. # TAGLINE\nSpecifically, the # TAGLINE\n\
- [Work Entity Reference](https://guide.fatcat.wiki/entity_work.html). # TAGLINE\n"
- x-displayName: "Works"
-- name: "editgroups"
- description: "**Editgroups** are sets of changes, each to individual entities in\
- \ the # TAGLINE\ncatalog. Every edit must be part of an editgroup which is reviewed\
- \ and # TAGLINE\naccepted (merged) as a whole. # TAGLINE\n"
- x-displayName: "Editgroups"
-- name: "editors"
- description: "**Editors** are human user accounts and bots that make changes to\
- \ the # TAGLINE\nFatcat catalog. # TAGLINE\n\nThe API allows fetching (and updating)\
- \ metadata about individual editors, # TAGLINE\nas well as fetching editor's\
- \ annotation and edit history. # TAGLINE\n"
- x-displayName: "Editors"
-- name: "changelog"
- description: "The **Changelog** is the ordered feed of editgroups which have been\
- \ # TAGLINE\naccepted into the catalog. # TAGLINE\n"
- x-displayName: "Changelog"
-- name: "auth"
- description: "Helper methods and internal APIs for editor authentication. # TAGLINE\n"
- x-displayName: "Auth Methods"
-schemes:
-- "https"
-consumes:
-- "application/json"
-produces:
-- "application/json"
-paths:
- /editgroup/{editgroup_id}/container:
- post:
- tags:
- - "containers"
- description: "Create a single Container entity as part of an existing editgroup.\n\
- \nEditgroup must be mutable (aka, not accepted) and editor must have\npermission\
- \ (aka, have created the editgrou p or have `admin` role).\n"
- operationId: "create_container"
- parameters:
- - name: "editgroup_id"
- in: "path"
- required: true
- type: "string"
- formatString: "\\\"{}\\\""
- example: "\"editgroup_id_example\".to_string()"
- - in: "body"
- name: "entity"
- required: true
- schema:
- $ref: "#/definitions/container_entity"
- uppercase_data_type: "CONTAINERENTITY"
- refName: "container_entity"
- formatString: "{:?}"
- example: "???"
- model_key: "editgroup_edits"
- uppercase_operation_id: "CREATE_CONTAINER"
- consumesJson: true
- responses:
- 201:
- description: "Created Entity"
- schema:
- $ref: "#/definitions/entity_edit"
- x-responseId: "CreatedEntity"
- x-uppercaseResponseId: "CREATED_ENTITY"
- uppercase_operation_id: "CREATE_CONTAINER"
- uppercase_data_type: "ENTITYEDIT"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "CREATE_CONTAINER"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 401:
- description: "Not Authorized"
- schema:
- $ref: "#/definitions/error_response"
- headers:
- WWW_Authenticate:
- type: "string"
- x-responseId: "NotAuthorized"
- x-uppercaseResponseId: "NOT_AUTHORIZED"
- uppercase_operation_id: "CREATE_CONTAINER"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 403:
- description: "Forbidden"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "Forbidden"
- x-uppercaseResponseId: "FORBIDDEN"
- uppercase_operation_id: "CREATE_CONTAINER"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "CREATE_CONTAINER"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "CREATE_CONTAINER"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- security:
- - Bearer: []
- operation_id: "create_container"
- uppercase_operation_id: "CREATE_CONTAINER"
- path: "/editgroup/:editgroup_id/container"
- HttpMethod: "Post"
- httpmethod: "post"
- noClientExample: true
- /editgroup/auto/container/batch:
- post:
- tags:
- - "containers"
- description: "Create a set of Container entities as part of a new editgroup,\
- \ and\naccept that editgroup in the same atomic request.\n\nThis method is\
- \ mostly useful for bulk import of new entities by\ncarefully written bots.\
- \ This method is more efficient than creating an\neditgroup, several entities,\
- \ then accepting the editgroup, both in\nterms of API requests required and\
- \ database load. Requires `admin`\nrole.\n"
- operationId: "create_container_auto_batch"
- parameters:
- - in: "body"
- name: "auto_batch"
- required: true
- schema:
- $ref: "#/definitions/container_auto_batch"
- uppercase_data_type: "CONTAINERAUTOBATCH"
- refName: "container_auto_batch"
- formatString: "{:?}"
- example: "???"
- model_key: "editgroup_edits"
- uppercase_operation_id: "CREATE_CONTAINER_AUTO_BATCH"
- consumesJson: true
- responses:
- 201:
- description: "Created Editgroup"
- schema:
- $ref: "#/definitions/editgroup"
- x-responseId: "CreatedEditgroup"
- x-uppercaseResponseId: "CREATED_EDITGROUP"
- uppercase_operation_id: "CREATE_CONTAINER_AUTO_BATCH"
- uppercase_data_type: "EDITGROUP"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "CREATE_CONTAINER_AUTO_BATCH"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 401:
- description: "Not Authorized"
- schema:
- $ref: "#/definitions/error_response"
- headers:
- WWW_Authenticate:
- type: "string"
- x-responseId: "NotAuthorized"
- x-uppercaseResponseId: "NOT_AUTHORIZED"
- uppercase_operation_id: "CREATE_CONTAINER_AUTO_BATCH"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 403:
- description: "Forbidden"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "Forbidden"
- x-uppercaseResponseId: "FORBIDDEN"
- uppercase_operation_id: "CREATE_CONTAINER_AUTO_BATCH"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "CREATE_CONTAINER_AUTO_BATCH"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "CREATE_CONTAINER_AUTO_BATCH"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- security:
- - Bearer: []
- operation_id: "create_container_auto_batch"
- uppercase_operation_id: "CREATE_CONTAINER_AUTO_BATCH"
- path: "/editgroup/auto/container/batch"
- HttpMethod: "Post"
- httpmethod: "post"
- noClientExample: true
- /container/{ident}:
- get:
- tags:
- - "containers"
- description: "Fetches a single container entity from the catalog.\n"
- operationId: "get_container"
- parameters:
- - name: "ident"
- in: "path"
- required: true
- type: "string"
- formatString: "\\\"{}\\\""
- example: "\"ident_example\".to_string()"
- - name: "expand"
- in: "query"
- description: "List of sub-entities to expand in response. For containers,\
- \ none accepted (yet)."
- required: false
- type: "string"
- formatString: "{:?}"
- example: "Some(\"expand_example\".to_string())"
- - name: "hide"
- in: "query"
- description: "List of entity fields to elide in response. For containers,\
- \ none accepted (yet)."
- required: false
- type: "string"
- formatString: "{:?}"
- example: "Some(\"hide_example\".to_string())"
- responses:
- 200:
- description: "Found Entity"
- schema:
- $ref: "#/definitions/container_entity"
- x-responseId: "FoundEntity"
- x-uppercaseResponseId: "FOUND_ENTITY"
- uppercase_operation_id: "GET_CONTAINER"
- uppercase_data_type: "CONTAINERENTITY"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "GET_CONTAINER"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "GET_CONTAINER"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "GET_CONTAINER"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- operation_id: "get_container"
- uppercase_operation_id: "GET_CONTAINER"
- path: "/container/:ident"
- HttpMethod: "Get"
- httpmethod: "get"
- /editgroup/{editgroup_id}/container/{ident}:
- put:
- tags:
- - "containers"
- description: "Updates an existing entity as part of a specific (existing) editgroup.\n\
- The editgroup must be open for updates (aka, not accepted/merged), and\nthe\
- \ editor making the requiest must have permissions (aka, must have\ncreated\
- \ the editgroup or have `admin` role).\n\nThis method can also be used to\
- \ update an existing entity edit as part\nof an editgroup. For example, if\
- \ an entity was created in this\neditgroup, an editor could make changes to\
- \ the new entity's metadata\nbefore merging.\n"
- operationId: "update_container"
- parameters:
- - name: "editgroup_id"
- in: "path"
- required: true
- type: "string"
- formatString: "\\\"{}\\\""
- example: "\"editgroup_id_example\".to_string()"
- - name: "ident"
- in: "path"
- required: true
- type: "string"
- formatString: "\\\"{}\\\""
- example: "\"ident_example\".to_string()"
- - in: "body"
- name: "entity"
- required: true
- schema:
- $ref: "#/definitions/container_entity"
- uppercase_data_type: "CONTAINERENTITY"
- refName: "container_entity"
- formatString: "{:?}"
- example: "???"
- model_key: "editgroup_edits"
- uppercase_operation_id: "UPDATE_CONTAINER"
- consumesJson: true
- responses:
- 200:
- description: "Updated Entity"
- schema:
- $ref: "#/definitions/entity_edit"
- x-responseId: "UpdatedEntity"
- x-uppercaseResponseId: "UPDATED_ENTITY"
- uppercase_operation_id: "UPDATE_CONTAINER"
- uppercase_data_type: "ENTITYEDIT"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "UPDATE_CONTAINER"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 401:
- description: "Not Authorized"
- schema:
- $ref: "#/definitions/error_response"
- headers:
- WWW_Authenticate:
- type: "string"
- x-responseId: "NotAuthorized"
- x-uppercaseResponseId: "NOT_AUTHORIZED"
- uppercase_operation_id: "UPDATE_CONTAINER"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 403:
- description: "Forbidden"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "Forbidden"
- x-uppercaseResponseId: "FORBIDDEN"
- uppercase_operation_id: "UPDATE_CONTAINER"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "UPDATE_CONTAINER"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "UPDATE_CONTAINER"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- security:
- - Bearer: []
- operation_id: "update_container"
- uppercase_operation_id: "UPDATE_CONTAINER"
- path: "/editgroup/:editgroup_id/container/:ident"
- HttpMethod: "Put"
- httpmethod: "put"
- noClientExample: true
- delete:
- tags:
- - "containers"
- description: "Creates a new \"deletion\" edit for a specific entity as part\
- \ of an\nexisting editgroup.\n\nThis is not the method to use to remove an\
- \ edit from an editgroup; for\nthat use `delete_container_edit`.\n"
- operationId: "delete_container"
- parameters:
- - name: "editgroup_id"
- in: "path"
- required: true
- type: "string"
- formatString: "\\\"{}\\\""
- example: "\"editgroup_id_example\".to_string()"
- - name: "ident"
- in: "path"
- required: true
- type: "string"
- formatString: "\\\"{}\\\""
- example: "\"ident_example\".to_string()"
- responses:
- 200:
- description: "Deleted Entity"
- schema:
- $ref: "#/definitions/entity_edit"
- x-responseId: "DeletedEntity"
- x-uppercaseResponseId: "DELETED_ENTITY"
- uppercase_operation_id: "DELETE_CONTAINER"
- uppercase_data_type: "ENTITYEDIT"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "DELETE_CONTAINER"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 401:
- description: "Not Authorized"
- schema:
- $ref: "#/definitions/error_response"
- headers:
- WWW_Authenticate:
- type: "string"
- x-responseId: "NotAuthorized"
- x-uppercaseResponseId: "NOT_AUTHORIZED"
- uppercase_operation_id: "DELETE_CONTAINER"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 403:
- description: "Forbidden"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "Forbidden"
- x-uppercaseResponseId: "FORBIDDEN"
- uppercase_operation_id: "DELETE_CONTAINER"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "DELETE_CONTAINER"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "DELETE_CONTAINER"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- security:
- - Bearer: []
- operation_id: "delete_container"
- uppercase_operation_id: "DELETE_CONTAINER"
- path: "/editgroup/:editgroup_id/container/:ident"
- HttpMethod: "Delete"
- httpmethod: "delete"
- /container/rev/{rev_id}:
- get:
- tags:
- - "containers"
- description: "Fetches a specific entity revision. Note that the returned revision\n\
- will not be associated with any particular fatcat identifier (even if\none\
- \ or more identifiers do currently point to this revision). The\nrevision\
- \ may even be part of an un-merged editgroup.\n\nRevisions are immutable and\
- \ can not be deleted or updated.\n"
- operationId: "get_container_revision"
- parameters:
- - name: "rev_id"
- in: "path"
- description: "UUID (lower-case, dash-separated, hex-encoded 128-bit)"
- required: true
- type: "string"
- maxLength: 36
- minLength: 36
- pattern: "[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}"
- formatString: "\\\"{}\\\""
- example: "\"rev_id_example\".to_string()"
- - name: "expand"
- in: "query"
- description: "List of sub-entities to expand in response. See `get_container`."
- required: false
- type: "string"
- formatString: "{:?}"
- example: "Some(\"expand_example\".to_string())"
- - name: "hide"
- in: "query"
- description: "List of entity fields to elide in response. See `get_container`."
- required: false
- type: "string"
- formatString: "{:?}"
- example: "Some(\"hide_example\".to_string())"
- responses:
- 200:
- description: "Found Entity Revision"
- schema:
- $ref: "#/definitions/container_entity"
- x-responseId: "FoundEntityRevision"
- x-uppercaseResponseId: "FOUND_ENTITY_REVISION"
- uppercase_operation_id: "GET_CONTAINER_REVISION"
- uppercase_data_type: "CONTAINERENTITY"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "GET_CONTAINER_REVISION"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "GET_CONTAINER_REVISION"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "GET_CONTAINER_REVISION"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- operation_id: "get_container_revision"
- uppercase_operation_id: "GET_CONTAINER_REVISION"
- path: "/container/rev/:rev_id"
- HttpMethod: "Get"
- httpmethod: "get"
- /container/{ident}/history:
- get:
- tags:
- - "containers"
- description: "Fetches the history of accepted edits (changelog entries) for\
- \ a\nspecific entity fatcat identifier.\n"
- operationId: "get_container_history"
- parameters:
- - name: "ident"
- in: "path"
- required: true
- type: "string"
- formatString: "\\\"{}\\\""
- example: "\"ident_example\".to_string()"
- - name: "limit"
- in: "query"
- description: "Maximum number of changelog entries to return"
- required: false
- type: "integer"
- format: "int64"
- formatString: "{:?}"
- example: "Some(789)"
- responses:
- 200:
- description: "Found Entity History"
- schema:
- type: "array"
- items:
- $ref: "#/definitions/entity_history_entry"
- x-responseId: "FoundEntityHistory"
- x-uppercaseResponseId: "FOUND_ENTITY_HISTORY"
- uppercase_operation_id: "GET_CONTAINER_HISTORY"
- uppercase_data_type: "VEC<ENTITYHISTORYENTRY>"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "GET_CONTAINER_HISTORY"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "GET_CONTAINER_HISTORY"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "GET_CONTAINER_HISTORY"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- operation_id: "get_container_history"
- uppercase_operation_id: "GET_CONTAINER_HISTORY"
- path: "/container/:ident/history"
- HttpMethod: "Get"
- httpmethod: "get"
- /container/{ident}/redirects:
- get:
- tags:
- - "containers"
- description: "Returns the set of entity identifiers which currently redirect\
- \ to this\nidentifier.\n"
- operationId: "get_container_redirects"
- parameters:
- - name: "ident"
- in: "path"
- required: true
- type: "string"
- formatString: "\\\"{}\\\""
- example: "\"ident_example\".to_string()"
- responses:
- 200:
- description: "Found Entity Redirects"
- schema:
- type: "array"
- items:
- type: "string"
- description: "base32-encoded unique identifier"
- minLength: 26
- maxLength: 26
- pattern: "[a-zA-Z2-7]{26}"
- x-responseId: "FoundEntityRedirects"
- x-uppercaseResponseId: "FOUND_ENTITY_REDIRECTS"
- uppercase_operation_id: "GET_CONTAINER_REDIRECTS"
- uppercase_data_type: "VEC<STRING>"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "GET_CONTAINER_REDIRECTS"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "GET_CONTAINER_REDIRECTS"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "GET_CONTAINER_REDIRECTS"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- operation_id: "get_container_redirects"
- uppercase_operation_id: "GET_CONTAINER_REDIRECTS"
- path: "/container/:ident/redirects"
- HttpMethod: "Get"
- httpmethod: "get"
- /container/lookup:
- get:
- tags:
- - "containers"
- description: "Looks for an active entity with the given external identifier.\
- \ If any\nsuch entity is found, returns a single complete entity. If multiple\n\
- entities have the same external identifier, this is considered a soft\ncatalog\
- \ error, and the behavior of which entity is returned is\nundefined.\n\nOne\
- \ (and only one) external identifier should be specified per request.\n"
- operationId: "lookup_container"
- parameters:
- - name: "issnl"
- in: "query"
- required: false
- type: "string"
- maxLength: 9
- minLength: 9
- pattern: "\\d{4}-\\d{3}[0-9X]"
- formatString: "{:?}"
- example: "Some(\"issnl_example\".to_string())"
- - name: "wikidata_qid"
- in: "query"
- required: false
- type: "string"
- formatString: "{:?}"
- example: "Some(\"wikidata_qid_example\".to_string())"
- - name: "expand"
- in: "query"
- description: "List of sub-entities to expand in response. See `get_container`."
- required: false
- type: "string"
- formatString: "{:?}"
- example: "Some(\"expand_example\".to_string())"
- - name: "hide"
- in: "query"
- description: "List of entity fields to elide in response. See `get_container`."
- required: false
- type: "string"
- formatString: "{:?}"
- example: "Some(\"hide_example\".to_string())"
- responses:
- 200:
- description: "Found Entity"
- schema:
- $ref: "#/definitions/container_entity"
- x-responseId: "FoundEntity"
- x-uppercaseResponseId: "FOUND_ENTITY"
- uppercase_operation_id: "LOOKUP_CONTAINER"
- uppercase_data_type: "CONTAINERENTITY"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "LOOKUP_CONTAINER"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "LOOKUP_CONTAINER"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "LOOKUP_CONTAINER"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- operation_id: "lookup_container"
- uppercase_operation_id: "LOOKUP_CONTAINER"
- path: "/container/lookup"
- HttpMethod: "Get"
- httpmethod: "get"
- /container/edit/{edit_id}:
- get:
- tags:
- - "containers"
- description: "Returns the entity edit object with the given identifier. This\
- \ method\nis expected to be used rarely.\n"
- operationId: "get_container_edit"
- parameters:
- - name: "edit_id"
- in: "path"
- description: "UUID (lower-case, dash-separated, hex-encoded 128-bit)"
- required: true
- type: "string"
- maxLength: 36
- minLength: 36
- pattern: "[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}"
- formatString: "\\\"{}\\\""
- example: "\"edit_id_example\".to_string()"
- responses:
- 200:
- description: "Found Edit"
- schema:
- $ref: "#/definitions/entity_edit"
- x-responseId: "FoundEdit"
- x-uppercaseResponseId: "FOUND_EDIT"
- uppercase_operation_id: "GET_CONTAINER_EDIT"
- uppercase_data_type: "ENTITYEDIT"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "GET_CONTAINER_EDIT"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "GET_CONTAINER_EDIT"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "GET_CONTAINER_EDIT"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- operation_id: "get_container_edit"
- uppercase_operation_id: "GET_CONTAINER_EDIT"
- path: "/container/edit/:edit_id"
- HttpMethod: "Get"
- httpmethod: "get"
- /editgroup/{editgroup_id}/container/edit/{edit_id}:
- delete:
- tags:
- - "containers"
- description: "Removes a single edit from the specified editgroup. The editgroup\
- \ must\nbe mutable (aka, not accepted/merged), and the editor making this\n\
- request must have permission (aka, have created the editgroup or hold\nthe\
- \ `admin` role).\n\nNot to be confused with the `delete_container` method,\
- \ which *creates*\na new edit in the given editgroup.\n"
- operationId: "delete_container_edit"
- parameters:
- - name: "editgroup_id"
- in: "path"
- required: true
- type: "string"
- formatString: "\\\"{}\\\""
- example: "\"editgroup_id_example\".to_string()"
- - name: "edit_id"
- in: "path"
- description: "UUID (lower-case, dash-separated, hex-encoded 128-bit)"
- required: true
- type: "string"
- maxLength: 36
- minLength: 36
- pattern: "[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}"
- formatString: "\\\"{}\\\""
- example: "\"edit_id_example\".to_string()"
- responses:
- 200:
- description: "Deleted Edit"
- schema:
- $ref: "#/definitions/success"
- x-responseId: "DeletedEdit"
- x-uppercaseResponseId: "DELETED_EDIT"
- uppercase_operation_id: "DELETE_CONTAINER_EDIT"
- uppercase_data_type: "SUCCESS"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "DELETE_CONTAINER_EDIT"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 401:
- description: "Not Authorized"
- schema:
- $ref: "#/definitions/error_response"
- headers:
- WWW_Authenticate:
- type: "string"
- x-responseId: "NotAuthorized"
- x-uppercaseResponseId: "NOT_AUTHORIZED"
- uppercase_operation_id: "DELETE_CONTAINER_EDIT"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 403:
- description: "Forbidden"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "Forbidden"
- x-uppercaseResponseId: "FORBIDDEN"
- uppercase_operation_id: "DELETE_CONTAINER_EDIT"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "DELETE_CONTAINER_EDIT"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "DELETE_CONTAINER_EDIT"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- security:
- - Bearer: []
- operation_id: "delete_container_edit"
- uppercase_operation_id: "DELETE_CONTAINER_EDIT"
- path: "/editgroup/:editgroup_id/container/edit/:edit_id"
- HttpMethod: "Delete"
- httpmethod: "delete"
- /editgroup/{editgroup_id}/creator:
- post:
- tags:
- - "creators"
- operationId: "create_creator"
- parameters:
- - name: "editgroup_id"
- in: "path"
- required: true
- type: "string"
- formatString: "\\\"{}\\\""
- example: "\"editgroup_id_example\".to_string()"
- - in: "body"
- name: "entity"
- required: true
- schema:
- $ref: "#/definitions/creator_entity"
- uppercase_data_type: "CREATORENTITY"
- refName: "creator_entity"
- formatString: "{:?}"
- example: "???"
- model_key: "editgroup_edits"
- uppercase_operation_id: "CREATE_CREATOR"
- consumesJson: true
- responses:
- 201:
- description: "Created Entity"
- schema:
- $ref: "#/definitions/entity_edit"
- x-responseId: "CreatedEntity"
- x-uppercaseResponseId: "CREATED_ENTITY"
- uppercase_operation_id: "CREATE_CREATOR"
- uppercase_data_type: "ENTITYEDIT"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "CREATE_CREATOR"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 401:
- description: "Not Authorized"
- schema:
- $ref: "#/definitions/error_response"
- headers:
- WWW_Authenticate:
- type: "string"
- x-responseId: "NotAuthorized"
- x-uppercaseResponseId: "NOT_AUTHORIZED"
- uppercase_operation_id: "CREATE_CREATOR"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 403:
- description: "Forbidden"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "Forbidden"
- x-uppercaseResponseId: "FORBIDDEN"
- uppercase_operation_id: "CREATE_CREATOR"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "CREATE_CREATOR"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "CREATE_CREATOR"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- security:
- - Bearer: []
- operation_id: "create_creator"
- uppercase_operation_id: "CREATE_CREATOR"
- path: "/editgroup/:editgroup_id/creator"
- HttpMethod: "Post"
- httpmethod: "post"
- noClientExample: true
- /editgroup/auto/creator/batch:
- post:
- tags:
- - "creators"
- operationId: "create_creator_auto_batch"
- parameters:
- - in: "body"
- name: "auto_batch"
- required: true
- schema:
- $ref: "#/definitions/creator_auto_batch"
- uppercase_data_type: "CREATORAUTOBATCH"
- refName: "creator_auto_batch"
- formatString: "{:?}"
- example: "???"
- model_key: "editgroup_edits"
- uppercase_operation_id: "CREATE_CREATOR_AUTO_BATCH"
- consumesJson: true
- responses:
- 201:
- description: "Created Editgroup"
- schema:
- $ref: "#/definitions/editgroup"
- x-responseId: "CreatedEditgroup"
- x-uppercaseResponseId: "CREATED_EDITGROUP"
- uppercase_operation_id: "CREATE_CREATOR_AUTO_BATCH"
- uppercase_data_type: "EDITGROUP"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "CREATE_CREATOR_AUTO_BATCH"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 401:
- description: "Not Authorized"
- schema:
- $ref: "#/definitions/error_response"
- headers:
- WWW_Authenticate:
- type: "string"
- x-responseId: "NotAuthorized"
- x-uppercaseResponseId: "NOT_AUTHORIZED"
- uppercase_operation_id: "CREATE_CREATOR_AUTO_BATCH"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 403:
- description: "Forbidden"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "Forbidden"
- x-uppercaseResponseId: "FORBIDDEN"
- uppercase_operation_id: "CREATE_CREATOR_AUTO_BATCH"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "CREATE_CREATOR_AUTO_BATCH"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "CREATE_CREATOR_AUTO_BATCH"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- security:
- - Bearer: []
- operation_id: "create_creator_auto_batch"
- uppercase_operation_id: "CREATE_CREATOR_AUTO_BATCH"
- path: "/editgroup/auto/creator/batch"
- HttpMethod: "Post"
- httpmethod: "post"
- noClientExample: true
- /creator/{ident}:
- get:
- tags:
- - "creators"
- operationId: "get_creator"
- parameters:
- - name: "ident"
- in: "path"
- required: true
- type: "string"
- formatString: "\\\"{}\\\""
- example: "\"ident_example\".to_string()"
- - name: "expand"
- in: "query"
- description: "List of sub-entities to expand in response. For creators, none\
- \ accepted (yet)."
- required: false
- type: "string"
- formatString: "{:?}"
- example: "Some(\"expand_example\".to_string())"
- - name: "hide"
- in: "query"
- description: "List of entity fields to elide in response. For creators, none\
- \ accepted (yet)."
- required: false
- type: "string"
- formatString: "{:?}"
- example: "Some(\"hide_example\".to_string())"
- responses:
- 200:
- description: "Found Entity"
- schema:
- $ref: "#/definitions/creator_entity"
- x-responseId: "FoundEntity"
- x-uppercaseResponseId: "FOUND_ENTITY"
- uppercase_operation_id: "GET_CREATOR"
- uppercase_data_type: "CREATORENTITY"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "GET_CREATOR"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "GET_CREATOR"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "GET_CREATOR"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- operation_id: "get_creator"
- uppercase_operation_id: "GET_CREATOR"
- path: "/creator/:ident"
- HttpMethod: "Get"
- httpmethod: "get"
- /editgroup/{editgroup_id}/creator/{ident}:
- put:
- tags:
- - "creators"
- operationId: "update_creator"
- parameters:
- - name: "editgroup_id"
- in: "path"
- required: true
- type: "string"
- formatString: "\\\"{}\\\""
- example: "\"editgroup_id_example\".to_string()"
- - name: "ident"
- in: "path"
- required: true
- type: "string"
- formatString: "\\\"{}\\\""
- example: "\"ident_example\".to_string()"
- - in: "body"
- name: "entity"
- required: true
- schema:
- $ref: "#/definitions/creator_entity"
- uppercase_data_type: "CREATORENTITY"
- refName: "creator_entity"
- formatString: "{:?}"
- example: "???"
- model_key: "editgroup_edits"
- uppercase_operation_id: "UPDATE_CREATOR"
- consumesJson: true
- responses:
- 200:
- description: "Updated Entity"
- schema:
- $ref: "#/definitions/entity_edit"
- x-responseId: "UpdatedEntity"
- x-uppercaseResponseId: "UPDATED_ENTITY"
- uppercase_operation_id: "UPDATE_CREATOR"
- uppercase_data_type: "ENTITYEDIT"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "UPDATE_CREATOR"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 401:
- description: "Not Authorized"
- schema:
- $ref: "#/definitions/error_response"
- headers:
- WWW_Authenticate:
- type: "string"
- x-responseId: "NotAuthorized"
- x-uppercaseResponseId: "NOT_AUTHORIZED"
- uppercase_operation_id: "UPDATE_CREATOR"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 403:
- description: "Forbidden"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "Forbidden"
- x-uppercaseResponseId: "FORBIDDEN"
- uppercase_operation_id: "UPDATE_CREATOR"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "UPDATE_CREATOR"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "UPDATE_CREATOR"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- security:
- - Bearer: []
- operation_id: "update_creator"
- uppercase_operation_id: "UPDATE_CREATOR"
- path: "/editgroup/:editgroup_id/creator/:ident"
- HttpMethod: "Put"
- httpmethod: "put"
- noClientExample: true
- delete:
- tags:
- - "creators"
- operationId: "delete_creator"
- parameters:
- - name: "editgroup_id"
- in: "path"
- required: true
- type: "string"
- formatString: "\\\"{}\\\""
- example: "\"editgroup_id_example\".to_string()"
- - name: "ident"
- in: "path"
- required: true
- type: "string"
- formatString: "\\\"{}\\\""
- example: "\"ident_example\".to_string()"
- responses:
- 200:
- description: "Deleted Entity"
- schema:
- $ref: "#/definitions/entity_edit"
- x-responseId: "DeletedEntity"
- x-uppercaseResponseId: "DELETED_ENTITY"
- uppercase_operation_id: "DELETE_CREATOR"
- uppercase_data_type: "ENTITYEDIT"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "DELETE_CREATOR"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 401:
- description: "Not Authorized"
- schema:
- $ref: "#/definitions/error_response"
- headers:
- WWW_Authenticate:
- type: "string"
- x-responseId: "NotAuthorized"
- x-uppercaseResponseId: "NOT_AUTHORIZED"
- uppercase_operation_id: "DELETE_CREATOR"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 403:
- description: "Forbidden"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "Forbidden"
- x-uppercaseResponseId: "FORBIDDEN"
- uppercase_operation_id: "DELETE_CREATOR"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "DELETE_CREATOR"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "DELETE_CREATOR"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- security:
- - Bearer: []
- operation_id: "delete_creator"
- uppercase_operation_id: "DELETE_CREATOR"
- path: "/editgroup/:editgroup_id/creator/:ident"
- HttpMethod: "Delete"
- httpmethod: "delete"
- /creator/rev/{rev_id}:
- get:
- tags:
- - "creators"
- operationId: "get_creator_revision"
- parameters:
- - name: "rev_id"
- in: "path"
- description: "UUID (lower-case, dash-separated, hex-encoded 128-bit)"
- required: true
- type: "string"
- maxLength: 36
- minLength: 36
- pattern: "[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}"
- formatString: "\\\"{}\\\""
- example: "\"rev_id_example\".to_string()"
- - name: "expand"
- in: "query"
- description: "List of sub-entities to expand in response. See `get_creator`,\n\
- though note that identifier-based expansions (like `releases`) will\nalways\
- \ be empty for revisions.\n"
- required: false
- type: "string"
- formatString: "{:?}"
- example: "Some(\"expand_example\".to_string())"
- - name: "hide"
- in: "query"
- description: "List of entity fields to elide in response. See `get_creator`."
- required: false
- type: "string"
- formatString: "{:?}"
- example: "Some(\"hide_example\".to_string())"
- responses:
- 200:
- description: "Found Entity Revision"
- schema:
- $ref: "#/definitions/creator_entity"
- x-responseId: "FoundEntityRevision"
- x-uppercaseResponseId: "FOUND_ENTITY_REVISION"
- uppercase_operation_id: "GET_CREATOR_REVISION"
- uppercase_data_type: "CREATORENTITY"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "GET_CREATOR_REVISION"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "GET_CREATOR_REVISION"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "GET_CREATOR_REVISION"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- operation_id: "get_creator_revision"
- uppercase_operation_id: "GET_CREATOR_REVISION"
- path: "/creator/rev/:rev_id"
- HttpMethod: "Get"
- httpmethod: "get"
- /creator/{ident}/history:
- get:
- tags:
- - "creators"
- operationId: "get_creator_history"
- parameters:
- - name: "ident"
- in: "path"
- required: true
- type: "string"
- formatString: "\\\"{}\\\""
- example: "\"ident_example\".to_string()"
- - name: "limit"
- in: "query"
- required: false
- type: "integer"
- format: "int64"
- formatString: "{:?}"
- example: "Some(789)"
- responses:
- 200:
- description: "Found Entity History"
- schema:
- type: "array"
- items:
- $ref: "#/definitions/entity_history_entry"
- x-responseId: "FoundEntityHistory"
- x-uppercaseResponseId: "FOUND_ENTITY_HISTORY"
- uppercase_operation_id: "GET_CREATOR_HISTORY"
- uppercase_data_type: "VEC<ENTITYHISTORYENTRY>"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "GET_CREATOR_HISTORY"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "GET_CREATOR_HISTORY"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "GET_CREATOR_HISTORY"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- operation_id: "get_creator_history"
- uppercase_operation_id: "GET_CREATOR_HISTORY"
- path: "/creator/:ident/history"
- HttpMethod: "Get"
- httpmethod: "get"
- /creator/{ident}/releases:
- get:
- tags:
- - "creators"
- description: "Returns the set of Release entities having a `contrib` entry pointing\n\
- to the creator entity.\n"
- operationId: "get_creator_releases"
- parameters:
- - name: "ident"
- in: "path"
- required: true
- type: "string"
- formatString: "\\\"{}\\\""
- example: "\"ident_example\".to_string()"
- - name: "hide"
- in: "query"
- description: "List of entity fields to elide in response. See `get_release`."
- required: false
- type: "string"
- formatString: "{:?}"
- example: "Some(\"hide_example\".to_string())"
- responses:
- 200:
- description: "Found"
- schema:
- type: "array"
- items:
- $ref: "#/definitions/release_entity"
- x-responseId: "Found"
- x-uppercaseResponseId: "FOUND"
- uppercase_operation_id: "GET_CREATOR_RELEASES"
- uppercase_data_type: "VEC<RELEASEENTITY>"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "GET_CREATOR_RELEASES"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "GET_CREATOR_RELEASES"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "GET_CREATOR_RELEASES"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- operation_id: "get_creator_releases"
- uppercase_operation_id: "GET_CREATOR_RELEASES"
- path: "/creator/:ident/releases"
- HttpMethod: "Get"
- httpmethod: "get"
- /creator/{ident}/redirects:
- get:
- tags:
- - "creators"
- operationId: "get_creator_redirects"
- parameters:
- - name: "ident"
- in: "path"
- required: true
- type: "string"
- formatString: "\\\"{}\\\""
- example: "\"ident_example\".to_string()"
- responses:
- 200:
- description: "Found Entity Redirects"
- schema:
- type: "array"
- items:
- type: "string"
- description: "base32-encoded unique identifier"
- minLength: 26
- maxLength: 26
- pattern: "[a-zA-Z2-7]{26}"
- x-responseId: "FoundEntityRedirects"
- x-uppercaseResponseId: "FOUND_ENTITY_REDIRECTS"
- uppercase_operation_id: "GET_CREATOR_REDIRECTS"
- uppercase_data_type: "VEC<STRING>"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "GET_CREATOR_REDIRECTS"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "GET_CREATOR_REDIRECTS"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "GET_CREATOR_REDIRECTS"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- operation_id: "get_creator_redirects"
- uppercase_operation_id: "GET_CREATOR_REDIRECTS"
- path: "/creator/:ident/redirects"
- HttpMethod: "Get"
- httpmethod: "get"
- /creator/lookup:
- get:
- tags:
- - "creators"
- operationId: "lookup_creator"
- parameters:
- - name: "orcid"
- in: "query"
- description: "ORCiD (https://orcid.org) identifier"
- required: false
- type: "string"
- maxLength: 19
- minLength: 19
- pattern: "\\d{4}-\\d{4}-\\d{4}-\\d{3}[\\dX]"
- formatString: "{:?}"
- example: "Some(\"orcid_example\".to_string())"
- - name: "wikidata_qid"
- in: "query"
- required: false
- type: "string"
- formatString: "{:?}"
- example: "Some(\"wikidata_qid_example\".to_string())"
- - name: "expand"
- in: "query"
- description: "List of sub-entities to expand in response. See `get_creator`."
- required: false
- type: "string"
- formatString: "{:?}"
- example: "Some(\"expand_example\".to_string())"
- - name: "hide"
- in: "query"
- description: "List of entity fields to elide in response. See `get_creator`."
- required: false
- type: "string"
- formatString: "{:?}"
- example: "Some(\"hide_example\".to_string())"
- responses:
- 200:
- description: "Found Entity"
- schema:
- $ref: "#/definitions/creator_entity"
- x-responseId: "FoundEntity"
- x-uppercaseResponseId: "FOUND_ENTITY"
- uppercase_operation_id: "LOOKUP_CREATOR"
- uppercase_data_type: "CREATORENTITY"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "LOOKUP_CREATOR"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "LOOKUP_CREATOR"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "LOOKUP_CREATOR"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- operation_id: "lookup_creator"
- uppercase_operation_id: "LOOKUP_CREATOR"
- path: "/creator/lookup"
- HttpMethod: "Get"
- httpmethod: "get"
- /creator/edit/{edit_id}:
- get:
- tags:
- - "creators"
- operationId: "get_creator_edit"
- parameters:
- - name: "edit_id"
- in: "path"
- description: "UUID (lower-case, dash-separated, hex-encoded 128-bit)"
- required: true
- type: "string"
- maxLength: 36
- minLength: 36
- pattern: "[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}"
- formatString: "\\\"{}\\\""
- example: "\"edit_id_example\".to_string()"
- responses:
- 200:
- description: "Found Edit"
- schema:
- $ref: "#/definitions/entity_edit"
- x-responseId: "FoundEdit"
- x-uppercaseResponseId: "FOUND_EDIT"
- uppercase_operation_id: "GET_CREATOR_EDIT"
- uppercase_data_type: "ENTITYEDIT"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "GET_CREATOR_EDIT"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "GET_CREATOR_EDIT"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "GET_CREATOR_EDIT"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- operation_id: "get_creator_edit"
- uppercase_operation_id: "GET_CREATOR_EDIT"
- path: "/creator/edit/:edit_id"
- HttpMethod: "Get"
- httpmethod: "get"
- /editgroup/{editgroup_id}/creator/edit/{edit_id}:
- delete:
- tags:
- - "creators"
- operationId: "delete_creator_edit"
- parameters:
- - name: "editgroup_id"
- in: "path"
- required: true
- type: "string"
- formatString: "\\\"{}\\\""
- example: "\"editgroup_id_example\".to_string()"
- - name: "edit_id"
- in: "path"
- description: "UUID (lower-case, dash-separated, hex-encoded 128-bit)"
- required: true
- type: "string"
- maxLength: 36
- minLength: 36
- pattern: "[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}"
- formatString: "\\\"{}\\\""
- example: "\"edit_id_example\".to_string()"
- responses:
- 200:
- description: "Deleted Edit"
- schema:
- $ref: "#/definitions/success"
- x-responseId: "DeletedEdit"
- x-uppercaseResponseId: "DELETED_EDIT"
- uppercase_operation_id: "DELETE_CREATOR_EDIT"
- uppercase_data_type: "SUCCESS"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "DELETE_CREATOR_EDIT"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 401:
- description: "Not Authorized"
- schema:
- $ref: "#/definitions/error_response"
- headers:
- WWW_Authenticate:
- type: "string"
- x-responseId: "NotAuthorized"
- x-uppercaseResponseId: "NOT_AUTHORIZED"
- uppercase_operation_id: "DELETE_CREATOR_EDIT"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 403:
- description: "Forbidden"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "Forbidden"
- x-uppercaseResponseId: "FORBIDDEN"
- uppercase_operation_id: "DELETE_CREATOR_EDIT"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "DELETE_CREATOR_EDIT"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "DELETE_CREATOR_EDIT"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- security:
- - Bearer: []
- operation_id: "delete_creator_edit"
- uppercase_operation_id: "DELETE_CREATOR_EDIT"
- path: "/editgroup/:editgroup_id/creator/edit/:edit_id"
- HttpMethod: "Delete"
- httpmethod: "delete"
- /editgroup/{editgroup_id}/file:
- post:
- tags:
- - "files"
- operationId: "create_file"
- parameters:
- - name: "editgroup_id"
- in: "path"
- required: true
- type: "string"
- formatString: "\\\"{}\\\""
- example: "\"editgroup_id_example\".to_string()"
- - in: "body"
- name: "entity"
- required: true
- schema:
- $ref: "#/definitions/file_entity"
- uppercase_data_type: "FILEENTITY"
- refName: "file_entity"
- formatString: "{:?}"
- example: "???"
- model_key: "editgroup_edits"
- uppercase_operation_id: "CREATE_FILE"
- consumesJson: true
- responses:
- 201:
- description: "Created Entity"
- schema:
- $ref: "#/definitions/entity_edit"
- x-responseId: "CreatedEntity"
- x-uppercaseResponseId: "CREATED_ENTITY"
- uppercase_operation_id: "CREATE_FILE"
- uppercase_data_type: "ENTITYEDIT"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "CREATE_FILE"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 401:
- description: "Not Authorized"
- schema:
- $ref: "#/definitions/error_response"
- headers:
- WWW_Authenticate:
- type: "string"
- x-responseId: "NotAuthorized"
- x-uppercaseResponseId: "NOT_AUTHORIZED"
- uppercase_operation_id: "CREATE_FILE"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 403:
- description: "Forbidden"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "Forbidden"
- x-uppercaseResponseId: "FORBIDDEN"
- uppercase_operation_id: "CREATE_FILE"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "CREATE_FILE"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "CREATE_FILE"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- security:
- - Bearer: []
- operation_id: "create_file"
- uppercase_operation_id: "CREATE_FILE"
- path: "/editgroup/:editgroup_id/file"
- HttpMethod: "Post"
- httpmethod: "post"
- noClientExample: true
- /editgroup/auto/file/batch:
- post:
- tags:
- - "files"
- operationId: "create_file_auto_batch"
- parameters:
- - in: "body"
- name: "auto_batch"
- required: true
- schema:
- $ref: "#/definitions/file_auto_batch"
- uppercase_data_type: "FILEAUTOBATCH"
- refName: "file_auto_batch"
- formatString: "{:?}"
- example: "???"
- model_key: "editgroup_edits"
- uppercase_operation_id: "CREATE_FILE_AUTO_BATCH"
- consumesJson: true
- responses:
- 201:
- description: "Created Editgroup"
- schema:
- $ref: "#/definitions/editgroup"
- x-responseId: "CreatedEditgroup"
- x-uppercaseResponseId: "CREATED_EDITGROUP"
- uppercase_operation_id: "CREATE_FILE_AUTO_BATCH"
- uppercase_data_type: "EDITGROUP"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "CREATE_FILE_AUTO_BATCH"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 401:
- description: "Not Authorized"
- schema:
- $ref: "#/definitions/error_response"
- headers:
- WWW_Authenticate:
- type: "string"
- x-responseId: "NotAuthorized"
- x-uppercaseResponseId: "NOT_AUTHORIZED"
- uppercase_operation_id: "CREATE_FILE_AUTO_BATCH"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 403:
- description: "Forbidden"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "Forbidden"
- x-uppercaseResponseId: "FORBIDDEN"
- uppercase_operation_id: "CREATE_FILE_AUTO_BATCH"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "CREATE_FILE_AUTO_BATCH"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "CREATE_FILE_AUTO_BATCH"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- security:
- - Bearer: []
- operation_id: "create_file_auto_batch"
- uppercase_operation_id: "CREATE_FILE_AUTO_BATCH"
- path: "/editgroup/auto/file/batch"
- HttpMethod: "Post"
- httpmethod: "post"
- noClientExample: true
- /file/{ident}:
- get:
- tags:
- - "files"
- operationId: "get_file"
- parameters:
- - name: "ident"
- in: "path"
- required: true
- type: "string"
- formatString: "\\\"{}\\\""
- example: "\"ident_example\".to_string()"
- - name: "expand"
- in: "query"
- description: "List of sub-entities to expand in response. For files, `releases`\
- \ is accepted."
- required: false
- type: "string"
- formatString: "{:?}"
- example: "Some(\"expand_example\".to_string())"
- - name: "hide"
- in: "query"
- description: "List of entity fields to elide in response. For files, none\
- \ accepted (yet)."
- required: false
- type: "string"
- formatString: "{:?}"
- example: "Some(\"hide_example\".to_string())"
- responses:
- 200:
- description: "Found Entity"
- schema:
- $ref: "#/definitions/file_entity"
- x-responseId: "FoundEntity"
- x-uppercaseResponseId: "FOUND_ENTITY"
- uppercase_operation_id: "GET_FILE"
- uppercase_data_type: "FILEENTITY"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "GET_FILE"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "GET_FILE"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "GET_FILE"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- operation_id: "get_file"
- uppercase_operation_id: "GET_FILE"
- path: "/file/:ident"
- HttpMethod: "Get"
- httpmethod: "get"
- /editgroup/{editgroup_id}/file/{ident}:
- put:
- tags:
- - "files"
- operationId: "update_file"
- parameters:
- - name: "editgroup_id"
- in: "path"
- required: true
- type: "string"
- formatString: "\\\"{}\\\""
- example: "\"editgroup_id_example\".to_string()"
- - name: "ident"
- in: "path"
- required: true
- type: "string"
- formatString: "\\\"{}\\\""
- example: "\"ident_example\".to_string()"
- - in: "body"
- name: "entity"
- required: true
- schema:
- $ref: "#/definitions/file_entity"
- uppercase_data_type: "FILEENTITY"
- refName: "file_entity"
- formatString: "{:?}"
- example: "???"
- model_key: "editgroup_edits"
- uppercase_operation_id: "UPDATE_FILE"
- consumesJson: true
- responses:
- 200:
- description: "Updated Entity"
- schema:
- $ref: "#/definitions/entity_edit"
- x-responseId: "UpdatedEntity"
- x-uppercaseResponseId: "UPDATED_ENTITY"
- uppercase_operation_id: "UPDATE_FILE"
- uppercase_data_type: "ENTITYEDIT"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "UPDATE_FILE"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 401:
- description: "Not Authorized"
- schema:
- $ref: "#/definitions/error_response"
- headers:
- WWW_Authenticate:
- type: "string"
- x-responseId: "NotAuthorized"
- x-uppercaseResponseId: "NOT_AUTHORIZED"
- uppercase_operation_id: "UPDATE_FILE"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 403:
- description: "Forbidden"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "Forbidden"
- x-uppercaseResponseId: "FORBIDDEN"
- uppercase_operation_id: "UPDATE_FILE"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "UPDATE_FILE"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "UPDATE_FILE"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- security:
- - Bearer: []
- operation_id: "update_file"
- uppercase_operation_id: "UPDATE_FILE"
- path: "/editgroup/:editgroup_id/file/:ident"
- HttpMethod: "Put"
- httpmethod: "put"
- noClientExample: true
- delete:
- tags:
- - "files"
- operationId: "delete_file"
- parameters:
- - name: "editgroup_id"
- in: "path"
- required: true
- type: "string"
- formatString: "\\\"{}\\\""
- example: "\"editgroup_id_example\".to_string()"
- - name: "ident"
- in: "path"
- required: true
- type: "string"
- formatString: "\\\"{}\\\""
- example: "\"ident_example\".to_string()"
- responses:
- 200:
- description: "Deleted Entity"
- schema:
- $ref: "#/definitions/entity_edit"
- x-responseId: "DeletedEntity"
- x-uppercaseResponseId: "DELETED_ENTITY"
- uppercase_operation_id: "DELETE_FILE"
- uppercase_data_type: "ENTITYEDIT"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "DELETE_FILE"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 401:
- description: "Not Authorized"
- schema:
- $ref: "#/definitions/error_response"
- headers:
- WWW_Authenticate:
- type: "string"
- x-responseId: "NotAuthorized"
- x-uppercaseResponseId: "NOT_AUTHORIZED"
- uppercase_operation_id: "DELETE_FILE"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 403:
- description: "Forbidden"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "Forbidden"
- x-uppercaseResponseId: "FORBIDDEN"
- uppercase_operation_id: "DELETE_FILE"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "DELETE_FILE"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "DELETE_FILE"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- security:
- - Bearer: []
- operation_id: "delete_file"
- uppercase_operation_id: "DELETE_FILE"
- path: "/editgroup/:editgroup_id/file/:ident"
- HttpMethod: "Delete"
- httpmethod: "delete"
- /file/rev/{rev_id}:
- get:
- tags:
- - "files"
- operationId: "get_file_revision"
- parameters:
- - name: "rev_id"
- in: "path"
- description: "UUID (lower-case, dash-separated, hex-encoded 128-bit)"
- required: true
- type: "string"
- maxLength: 36
- minLength: 36
- pattern: "[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}"
- formatString: "\\\"{}\\\""
- example: "\"rev_id_example\".to_string()"
- - name: "expand"
- in: "query"
- description: "List of sub-entities to expand in response. See `get_file`."
- required: false
- type: "string"
- formatString: "{:?}"
- example: "Some(\"expand_example\".to_string())"
- - name: "hide"
- in: "query"
- description: "List of entity fields to elide in response. See `get_file`."
- required: false
- type: "string"
- formatString: "{:?}"
- example: "Some(\"hide_example\".to_string())"
- responses:
- 200:
- description: "Found Entity Revision"
- schema:
- $ref: "#/definitions/file_entity"
- x-responseId: "FoundEntityRevision"
- x-uppercaseResponseId: "FOUND_ENTITY_REVISION"
- uppercase_operation_id: "GET_FILE_REVISION"
- uppercase_data_type: "FILEENTITY"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "GET_FILE_REVISION"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "GET_FILE_REVISION"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "GET_FILE_REVISION"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- operation_id: "get_file_revision"
- uppercase_operation_id: "GET_FILE_REVISION"
- path: "/file/rev/:rev_id"
- HttpMethod: "Get"
- httpmethod: "get"
- /file/{ident}/history:
- get:
- tags:
- - "files"
- operationId: "get_file_history"
- parameters:
- - name: "ident"
- in: "path"
- required: true
- type: "string"
- formatString: "\\\"{}\\\""
- example: "\"ident_example\".to_string()"
- - name: "limit"
- in: "query"
- required: false
- type: "integer"
- format: "int64"
- formatString: "{:?}"
- example: "Some(789)"
- responses:
- 200:
- description: "Found Entity History"
- schema:
- type: "array"
- items:
- $ref: "#/definitions/entity_history_entry"
- x-responseId: "FoundEntityHistory"
- x-uppercaseResponseId: "FOUND_ENTITY_HISTORY"
- uppercase_operation_id: "GET_FILE_HISTORY"
- uppercase_data_type: "VEC<ENTITYHISTORYENTRY>"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "GET_FILE_HISTORY"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "GET_FILE_HISTORY"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "GET_FILE_HISTORY"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- operation_id: "get_file_history"
- uppercase_operation_id: "GET_FILE_HISTORY"
- path: "/file/:ident/history"
- HttpMethod: "Get"
- httpmethod: "get"
- /file/{ident}/redirects:
- get:
- tags:
- - "files"
- operationId: "get_file_redirects"
- parameters:
- - name: "ident"
- in: "path"
- required: true
- type: "string"
- formatString: "\\\"{}\\\""
- example: "\"ident_example\".to_string()"
- responses:
- 200:
- description: "Found Entity Redirects"
- schema:
- type: "array"
- items:
- type: "string"
- description: "base32-encoded unique identifier"
- minLength: 26
- maxLength: 26
- pattern: "[a-zA-Z2-7]{26}"
- x-responseId: "FoundEntityRedirects"
- x-uppercaseResponseId: "FOUND_ENTITY_REDIRECTS"
- uppercase_operation_id: "GET_FILE_REDIRECTS"
- uppercase_data_type: "VEC<STRING>"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "GET_FILE_REDIRECTS"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "GET_FILE_REDIRECTS"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "GET_FILE_REDIRECTS"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- operation_id: "get_file_redirects"
- uppercase_operation_id: "GET_FILE_REDIRECTS"
- path: "/file/:ident/redirects"
- HttpMethod: "Get"
- httpmethod: "get"
- /file/lookup:
- get:
- tags:
- - "files"
- operationId: "lookup_file"
- parameters:
- - name: "md5"
- in: "query"
- description: "MD5 hash of data, in hex encoding"
- required: false
- type: "string"
- maxLength: 32
- minLength: 32
- pattern: "[a-f0-9]{32}"
- formatString: "{:?}"
- example: "Some(\"md5_example\".to_string())"
- - name: "sha1"
- in: "query"
- description: "SHA-1 hash of data, in hex encoding"
- required: false
- type: "string"
- maxLength: 40
- minLength: 40
- pattern: "[a-f0-9]{40}"
- formatString: "{:?}"
- example: "Some(\"sha1_example\".to_string())"
- - name: "sha256"
- in: "query"
- description: "SHA-256 hash of data, in hex encoding"
- required: false
- type: "string"
- maxLength: 64
- minLength: 64
- pattern: "[a-f0-9]{64}"
- formatString: "{:?}"
- example: "Some(\"sha256_example\".to_string())"
- - name: "expand"
- in: "query"
- description: "List of sub-entities to expand in response. See `get_file`."
- required: false
- type: "string"
- formatString: "{:?}"
- example: "Some(\"expand_example\".to_string())"
- - name: "hide"
- in: "query"
- description: "List of entity fields to elide in response. See `get_file`."
- required: false
- type: "string"
- formatString: "{:?}"
- example: "Some(\"hide_example\".to_string())"
- responses:
- 200:
- description: "Found Entity"
- schema:
- $ref: "#/definitions/file_entity"
- x-responseId: "FoundEntity"
- x-uppercaseResponseId: "FOUND_ENTITY"
- uppercase_operation_id: "LOOKUP_FILE"
- uppercase_data_type: "FILEENTITY"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "LOOKUP_FILE"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "LOOKUP_FILE"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "LOOKUP_FILE"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- operation_id: "lookup_file"
- uppercase_operation_id: "LOOKUP_FILE"
- path: "/file/lookup"
- HttpMethod: "Get"
- httpmethod: "get"
- /file/edit/{edit_id}:
- get:
- tags:
- - "files"
- operationId: "get_file_edit"
- parameters:
- - name: "edit_id"
- in: "path"
- description: "UUID (lower-case, dash-separated, hex-encoded 128-bit)"
- required: true
- type: "string"
- maxLength: 36
- minLength: 36
- pattern: "[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}"
- formatString: "\\\"{}\\\""
- example: "\"edit_id_example\".to_string()"
- responses:
- 200:
- description: "Found Edit"
- schema:
- $ref: "#/definitions/entity_edit"
- x-responseId: "FoundEdit"
- x-uppercaseResponseId: "FOUND_EDIT"
- uppercase_operation_id: "GET_FILE_EDIT"
- uppercase_data_type: "ENTITYEDIT"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "GET_FILE_EDIT"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "GET_FILE_EDIT"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "GET_FILE_EDIT"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- operation_id: "get_file_edit"
- uppercase_operation_id: "GET_FILE_EDIT"
- path: "/file/edit/:edit_id"
- HttpMethod: "Get"
- httpmethod: "get"
- /editgroup/{editgroup_id}/file/edit/{edit_id}:
- delete:
- tags:
- - "files"
- operationId: "delete_file_edit"
- parameters:
- - name: "editgroup_id"
- in: "path"
- required: true
- type: "string"
- formatString: "\\\"{}\\\""
- example: "\"editgroup_id_example\".to_string()"
- - name: "edit_id"
- in: "path"
- description: "UUID (lower-case, dash-separated, hex-encoded 128-bit)"
- required: true
- type: "string"
- maxLength: 36
- minLength: 36
- pattern: "[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}"
- formatString: "\\\"{}\\\""
- example: "\"edit_id_example\".to_string()"
- responses:
- 200:
- description: "Deleted Edit"
- schema:
- $ref: "#/definitions/success"
- x-responseId: "DeletedEdit"
- x-uppercaseResponseId: "DELETED_EDIT"
- uppercase_operation_id: "DELETE_FILE_EDIT"
- uppercase_data_type: "SUCCESS"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "DELETE_FILE_EDIT"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 401:
- description: "Not Authorized"
- schema:
- $ref: "#/definitions/error_response"
- headers:
- WWW_Authenticate:
- type: "string"
- x-responseId: "NotAuthorized"
- x-uppercaseResponseId: "NOT_AUTHORIZED"
- uppercase_operation_id: "DELETE_FILE_EDIT"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 403:
- description: "Forbidden"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "Forbidden"
- x-uppercaseResponseId: "FORBIDDEN"
- uppercase_operation_id: "DELETE_FILE_EDIT"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "DELETE_FILE_EDIT"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "DELETE_FILE_EDIT"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- security:
- - Bearer: []
- operation_id: "delete_file_edit"
- uppercase_operation_id: "DELETE_FILE_EDIT"
- path: "/editgroup/:editgroup_id/file/edit/:edit_id"
- HttpMethod: "Delete"
- httpmethod: "delete"
- /editgroup/{editgroup_id}/fileset:
- post:
- tags:
- - "filesets"
- operationId: "create_fileset"
- parameters:
- - name: "editgroup_id"
- in: "path"
- required: true
- type: "string"
- formatString: "\\\"{}\\\""
- example: "\"editgroup_id_example\".to_string()"
- - in: "body"
- name: "entity"
- required: true
- schema:
- $ref: "#/definitions/fileset_entity"
- uppercase_data_type: "FILESETENTITY"
- refName: "fileset_entity"
- formatString: "{:?}"
- example: "???"
- model_key: "editgroup_edits"
- uppercase_operation_id: "CREATE_FILESET"
- consumesJson: true
- responses:
- 201:
- description: "Created Entity"
- schema:
- $ref: "#/definitions/entity_edit"
- x-responseId: "CreatedEntity"
- x-uppercaseResponseId: "CREATED_ENTITY"
- uppercase_operation_id: "CREATE_FILESET"
- uppercase_data_type: "ENTITYEDIT"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "CREATE_FILESET"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 401:
- description: "Not Authorized"
- schema:
- $ref: "#/definitions/error_response"
- headers:
- WWW_Authenticate:
- type: "string"
- x-responseId: "NotAuthorized"
- x-uppercaseResponseId: "NOT_AUTHORIZED"
- uppercase_operation_id: "CREATE_FILESET"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 403:
- description: "Forbidden"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "Forbidden"
- x-uppercaseResponseId: "FORBIDDEN"
- uppercase_operation_id: "CREATE_FILESET"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "CREATE_FILESET"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "CREATE_FILESET"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- security:
- - Bearer: []
- operation_id: "create_fileset"
- uppercase_operation_id: "CREATE_FILESET"
- path: "/editgroup/:editgroup_id/fileset"
- HttpMethod: "Post"
- httpmethod: "post"
- noClientExample: true
- /editgroup/auto/fileset/batch:
- post:
- tags:
- - "filesets"
- operationId: "create_fileset_auto_batch"
- parameters:
- - in: "body"
- name: "auto_batch"
- required: true
- schema:
- $ref: "#/definitions/fileset_auto_batch"
- uppercase_data_type: "FILESETAUTOBATCH"
- refName: "fileset_auto_batch"
- formatString: "{:?}"
- example: "???"
- model_key: "editgroup_edits"
- uppercase_operation_id: "CREATE_FILESET_AUTO_BATCH"
- consumesJson: true
- responses:
- 201:
- description: "Created Editgroup"
- schema:
- $ref: "#/definitions/editgroup"
- x-responseId: "CreatedEditgroup"
- x-uppercaseResponseId: "CREATED_EDITGROUP"
- uppercase_operation_id: "CREATE_FILESET_AUTO_BATCH"
- uppercase_data_type: "EDITGROUP"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "CREATE_FILESET_AUTO_BATCH"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 401:
- description: "Not Authorized"
- schema:
- $ref: "#/definitions/error_response"
- headers:
- WWW_Authenticate:
- type: "string"
- x-responseId: "NotAuthorized"
- x-uppercaseResponseId: "NOT_AUTHORIZED"
- uppercase_operation_id: "CREATE_FILESET_AUTO_BATCH"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 403:
- description: "Forbidden"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "Forbidden"
- x-uppercaseResponseId: "FORBIDDEN"
- uppercase_operation_id: "CREATE_FILESET_AUTO_BATCH"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "CREATE_FILESET_AUTO_BATCH"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "CREATE_FILESET_AUTO_BATCH"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- security:
- - Bearer: []
- operation_id: "create_fileset_auto_batch"
- uppercase_operation_id: "CREATE_FILESET_AUTO_BATCH"
- path: "/editgroup/auto/fileset/batch"
- HttpMethod: "Post"
- httpmethod: "post"
- noClientExample: true
- /fileset/{ident}:
- get:
- tags:
- - "filesets"
- operationId: "get_fileset"
- parameters:
- - name: "ident"
- in: "path"
- required: true
- type: "string"
- formatString: "\\\"{}\\\""
- example: "\"ident_example\".to_string()"
- - name: "expand"
- in: "query"
- description: "List of sub-entities to expand in response. For filesets, `releases`\
- \ is accepted."
- required: false
- type: "string"
- formatString: "{:?}"
- example: "Some(\"expand_example\".to_string())"
- - name: "hide"
- in: "query"
- description: "List of entity fields to elide in response. For filesets, 'manifest'\
- \ is accepted."
- required: false
- type: "string"
- formatString: "{:?}"
- example: "Some(\"hide_example\".to_string())"
- responses:
- 200:
- description: "Found Entity"
- schema:
- $ref: "#/definitions/fileset_entity"
- x-responseId: "FoundEntity"
- x-uppercaseResponseId: "FOUND_ENTITY"
- uppercase_operation_id: "GET_FILESET"
- uppercase_data_type: "FILESETENTITY"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "GET_FILESET"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "GET_FILESET"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "GET_FILESET"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- operation_id: "get_fileset"
- uppercase_operation_id: "GET_FILESET"
- path: "/fileset/:ident"
- HttpMethod: "Get"
- httpmethod: "get"
- /editgroup/{editgroup_id}/fileset/{ident}:
- put:
- tags:
- - "filesets"
- operationId: "update_fileset"
- parameters:
- - name: "editgroup_id"
- in: "path"
- required: true
- type: "string"
- formatString: "\\\"{}\\\""
- example: "\"editgroup_id_example\".to_string()"
- - name: "ident"
- in: "path"
- required: true
- type: "string"
- formatString: "\\\"{}\\\""
- example: "\"ident_example\".to_string()"
- - in: "body"
- name: "entity"
- required: true
- schema:
- $ref: "#/definitions/fileset_entity"
- uppercase_data_type: "FILESETENTITY"
- refName: "fileset_entity"
- formatString: "{:?}"
- example: "???"
- model_key: "editgroup_edits"
- uppercase_operation_id: "UPDATE_FILESET"
- consumesJson: true
- responses:
- 200:
- description: "Updated Entity"
- schema:
- $ref: "#/definitions/entity_edit"
- x-responseId: "UpdatedEntity"
- x-uppercaseResponseId: "UPDATED_ENTITY"
- uppercase_operation_id: "UPDATE_FILESET"
- uppercase_data_type: "ENTITYEDIT"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "UPDATE_FILESET"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 401:
- description: "Not Authorized"
- schema:
- $ref: "#/definitions/error_response"
- headers:
- WWW_Authenticate:
- type: "string"
- x-responseId: "NotAuthorized"
- x-uppercaseResponseId: "NOT_AUTHORIZED"
- uppercase_operation_id: "UPDATE_FILESET"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 403:
- description: "Forbidden"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "Forbidden"
- x-uppercaseResponseId: "FORBIDDEN"
- uppercase_operation_id: "UPDATE_FILESET"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "UPDATE_FILESET"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "UPDATE_FILESET"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- security:
- - Bearer: []
- operation_id: "update_fileset"
- uppercase_operation_id: "UPDATE_FILESET"
- path: "/editgroup/:editgroup_id/fileset/:ident"
- HttpMethod: "Put"
- httpmethod: "put"
- noClientExample: true
- delete:
- tags:
- - "filesets"
- operationId: "delete_fileset"
- parameters:
- - name: "editgroup_id"
- in: "path"
- required: true
- type: "string"
- formatString: "\\\"{}\\\""
- example: "\"editgroup_id_example\".to_string()"
- - name: "ident"
- in: "path"
- required: true
- type: "string"
- formatString: "\\\"{}\\\""
- example: "\"ident_example\".to_string()"
- responses:
- 200:
- description: "Deleted Entity"
- schema:
- $ref: "#/definitions/entity_edit"
- x-responseId: "DeletedEntity"
- x-uppercaseResponseId: "DELETED_ENTITY"
- uppercase_operation_id: "DELETE_FILESET"
- uppercase_data_type: "ENTITYEDIT"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "DELETE_FILESET"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 401:
- description: "Not Authorized"
- schema:
- $ref: "#/definitions/error_response"
- headers:
- WWW_Authenticate:
- type: "string"
- x-responseId: "NotAuthorized"
- x-uppercaseResponseId: "NOT_AUTHORIZED"
- uppercase_operation_id: "DELETE_FILESET"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 403:
- description: "Forbidden"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "Forbidden"
- x-uppercaseResponseId: "FORBIDDEN"
- uppercase_operation_id: "DELETE_FILESET"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "DELETE_FILESET"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "DELETE_FILESET"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- security:
- - Bearer: []
- operation_id: "delete_fileset"
- uppercase_operation_id: "DELETE_FILESET"
- path: "/editgroup/:editgroup_id/fileset/:ident"
- HttpMethod: "Delete"
- httpmethod: "delete"
- /fileset/rev/{rev_id}:
- get:
- tags:
- - "filesets"
- operationId: "get_fileset_revision"
- parameters:
- - name: "rev_id"
- in: "path"
- description: "UUID (lower-case, dash-separated, hex-encoded 128-bit)"
- required: true
- type: "string"
- maxLength: 36
- minLength: 36
- pattern: "[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}"
- formatString: "\\\"{}\\\""
- example: "\"rev_id_example\".to_string()"
- - name: "expand"
- in: "query"
- description: "List of sub-entities to expand in response. See `get_fileset`."
- required: false
- type: "string"
- formatString: "{:?}"
- example: "Some(\"expand_example\".to_string())"
- - name: "hide"
- in: "query"
- description: "List of entity fields to elide in response. See `get_fileset`."
- required: false
- type: "string"
- formatString: "{:?}"
- example: "Some(\"hide_example\".to_string())"
- responses:
- 200:
- description: "Found Entity Revision"
- schema:
- $ref: "#/definitions/fileset_entity"
- x-responseId: "FoundEntityRevision"
- x-uppercaseResponseId: "FOUND_ENTITY_REVISION"
- uppercase_operation_id: "GET_FILESET_REVISION"
- uppercase_data_type: "FILESETENTITY"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "GET_FILESET_REVISION"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "GET_FILESET_REVISION"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "GET_FILESET_REVISION"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- operation_id: "get_fileset_revision"
- uppercase_operation_id: "GET_FILESET_REVISION"
- path: "/fileset/rev/:rev_id"
- HttpMethod: "Get"
- httpmethod: "get"
- /fileset/{ident}/history:
- get:
- tags:
- - "filesets"
- operationId: "get_fileset_history"
- parameters:
- - name: "ident"
- in: "path"
- required: true
- type: "string"
- formatString: "\\\"{}\\\""
- example: "\"ident_example\".to_string()"
- - name: "limit"
- in: "query"
- required: false
- type: "integer"
- format: "int64"
- formatString: "{:?}"
- example: "Some(789)"
- responses:
- 200:
- description: "Found Entity History"
- schema:
- type: "array"
- items:
- $ref: "#/definitions/entity_history_entry"
- x-responseId: "FoundEntityHistory"
- x-uppercaseResponseId: "FOUND_ENTITY_HISTORY"
- uppercase_operation_id: "GET_FILESET_HISTORY"
- uppercase_data_type: "VEC<ENTITYHISTORYENTRY>"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "GET_FILESET_HISTORY"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "GET_FILESET_HISTORY"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "GET_FILESET_HISTORY"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- operation_id: "get_fileset_history"
- uppercase_operation_id: "GET_FILESET_HISTORY"
- path: "/fileset/:ident/history"
- HttpMethod: "Get"
- httpmethod: "get"
- /fileset/{ident}/redirects:
- get:
- tags:
- - "filesets"
- operationId: "get_fileset_redirects"
- parameters:
- - name: "ident"
- in: "path"
- required: true
- type: "string"
- formatString: "\\\"{}\\\""
- example: "\"ident_example\".to_string()"
- responses:
- 200:
- description: "Found Entity Redirects"
- schema:
- type: "array"
- items:
- type: "string"
- description: "base32-encoded unique identifier"
- minLength: 26
- maxLength: 26
- pattern: "[a-zA-Z2-7]{26}"
- x-responseId: "FoundEntityRedirects"
- x-uppercaseResponseId: "FOUND_ENTITY_REDIRECTS"
- uppercase_operation_id: "GET_FILESET_REDIRECTS"
- uppercase_data_type: "VEC<STRING>"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "GET_FILESET_REDIRECTS"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "GET_FILESET_REDIRECTS"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "GET_FILESET_REDIRECTS"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- operation_id: "get_fileset_redirects"
- uppercase_operation_id: "GET_FILESET_REDIRECTS"
- path: "/fileset/:ident/redirects"
- HttpMethod: "Get"
- httpmethod: "get"
- /fileset/edit/{edit_id}:
- get:
- tags:
- - "filesets"
- operationId: "get_fileset_edit"
- parameters:
- - name: "edit_id"
- in: "path"
- description: "UUID (lower-case, dash-separated, hex-encoded 128-bit)"
- required: true
- type: "string"
- maxLength: 36
- minLength: 36
- pattern: "[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}"
- formatString: "\\\"{}\\\""
- example: "\"edit_id_example\".to_string()"
- responses:
- 200:
- description: "Found Edit"
- schema:
- $ref: "#/definitions/entity_edit"
- x-responseId: "FoundEdit"
- x-uppercaseResponseId: "FOUND_EDIT"
- uppercase_operation_id: "GET_FILESET_EDIT"
- uppercase_data_type: "ENTITYEDIT"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "GET_FILESET_EDIT"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "GET_FILESET_EDIT"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "GET_FILESET_EDIT"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- operation_id: "get_fileset_edit"
- uppercase_operation_id: "GET_FILESET_EDIT"
- path: "/fileset/edit/:edit_id"
- HttpMethod: "Get"
- httpmethod: "get"
- /editgroup/{editgroup_id}/fileset/edit/{edit_id}:
- delete:
- tags:
- - "filesets"
- operationId: "delete_fileset_edit"
- parameters:
- - name: "editgroup_id"
- in: "path"
- required: true
- type: "string"
- formatString: "\\\"{}\\\""
- example: "\"editgroup_id_example\".to_string()"
- - name: "edit_id"
- in: "path"
- description: "UUID (lower-case, dash-separated, hex-encoded 128-bit)"
- required: true
- type: "string"
- maxLength: 36
- minLength: 36
- pattern: "[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}"
- formatString: "\\\"{}\\\""
- example: "\"edit_id_example\".to_string()"
- responses:
- 200:
- description: "Deleted Edit"
- schema:
- $ref: "#/definitions/success"
- x-responseId: "DeletedEdit"
- x-uppercaseResponseId: "DELETED_EDIT"
- uppercase_operation_id: "DELETE_FILESET_EDIT"
- uppercase_data_type: "SUCCESS"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "DELETE_FILESET_EDIT"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 401:
- description: "Not Authorized"
- schema:
- $ref: "#/definitions/error_response"
- headers:
- WWW_Authenticate:
- type: "string"
- x-responseId: "NotAuthorized"
- x-uppercaseResponseId: "NOT_AUTHORIZED"
- uppercase_operation_id: "DELETE_FILESET_EDIT"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 403:
- description: "Forbidden"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "Forbidden"
- x-uppercaseResponseId: "FORBIDDEN"
- uppercase_operation_id: "DELETE_FILESET_EDIT"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "DELETE_FILESET_EDIT"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "DELETE_FILESET_EDIT"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- security:
- - Bearer: []
- operation_id: "delete_fileset_edit"
- uppercase_operation_id: "DELETE_FILESET_EDIT"
- path: "/editgroup/:editgroup_id/fileset/edit/:edit_id"
- HttpMethod: "Delete"
- httpmethod: "delete"
- /editgroup/{editgroup_id}/webcapture:
- post:
- tags:
- - "webcaptures"
- operationId: "create_webcapture"
- parameters:
- - name: "editgroup_id"
- in: "path"
- required: true
- type: "string"
- formatString: "\\\"{}\\\""
- example: "\"editgroup_id_example\".to_string()"
- - in: "body"
- name: "entity"
- required: true
- schema:
- $ref: "#/definitions/webcapture_entity"
- uppercase_data_type: "WEBCAPTUREENTITY"
- refName: "webcapture_entity"
- formatString: "{:?}"
- example: "???"
- model_key: "editgroup_edits"
- uppercase_operation_id: "CREATE_WEBCAPTURE"
- consumesJson: true
- responses:
- 201:
- description: "Created Entity"
- schema:
- $ref: "#/definitions/entity_edit"
- x-responseId: "CreatedEntity"
- x-uppercaseResponseId: "CREATED_ENTITY"
- uppercase_operation_id: "CREATE_WEBCAPTURE"
- uppercase_data_type: "ENTITYEDIT"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "CREATE_WEBCAPTURE"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 401:
- description: "Not Authorized"
- schema:
- $ref: "#/definitions/error_response"
- headers:
- WWW_Authenticate:
- type: "string"
- x-responseId: "NotAuthorized"
- x-uppercaseResponseId: "NOT_AUTHORIZED"
- uppercase_operation_id: "CREATE_WEBCAPTURE"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 403:
- description: "Forbidden"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "Forbidden"
- x-uppercaseResponseId: "FORBIDDEN"
- uppercase_operation_id: "CREATE_WEBCAPTURE"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "CREATE_WEBCAPTURE"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "CREATE_WEBCAPTURE"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- security:
- - Bearer: []
- operation_id: "create_webcapture"
- uppercase_operation_id: "CREATE_WEBCAPTURE"
- path: "/editgroup/:editgroup_id/webcapture"
- HttpMethod: "Post"
- httpmethod: "post"
- noClientExample: true
- /editgroup/auto/webcapture/batch:
- post:
- tags:
- - "webcaptures"
- operationId: "create_webcapture_auto_batch"
- parameters:
- - in: "body"
- name: "auto_batch"
- required: true
- schema:
- $ref: "#/definitions/webcapture_auto_batch"
- uppercase_data_type: "WEBCAPTUREAUTOBATCH"
- refName: "webcapture_auto_batch"
- formatString: "{:?}"
- example: "???"
- model_key: "editgroup_edits"
- uppercase_operation_id: "CREATE_WEBCAPTURE_AUTO_BATCH"
- consumesJson: true
- responses:
- 201:
- description: "Created Editgroup"
- schema:
- $ref: "#/definitions/editgroup"
- x-responseId: "CreatedEditgroup"
- x-uppercaseResponseId: "CREATED_EDITGROUP"
- uppercase_operation_id: "CREATE_WEBCAPTURE_AUTO_BATCH"
- uppercase_data_type: "EDITGROUP"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "CREATE_WEBCAPTURE_AUTO_BATCH"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 401:
- description: "Not Authorized"
- schema:
- $ref: "#/definitions/error_response"
- headers:
- WWW_Authenticate:
- type: "string"
- x-responseId: "NotAuthorized"
- x-uppercaseResponseId: "NOT_AUTHORIZED"
- uppercase_operation_id: "CREATE_WEBCAPTURE_AUTO_BATCH"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 403:
- description: "Forbidden"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "Forbidden"
- x-uppercaseResponseId: "FORBIDDEN"
- uppercase_operation_id: "CREATE_WEBCAPTURE_AUTO_BATCH"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "CREATE_WEBCAPTURE_AUTO_BATCH"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "CREATE_WEBCAPTURE_AUTO_BATCH"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- security:
- - Bearer: []
- operation_id: "create_webcapture_auto_batch"
- uppercase_operation_id: "CREATE_WEBCAPTURE_AUTO_BATCH"
- path: "/editgroup/auto/webcapture/batch"
- HttpMethod: "Post"
- httpmethod: "post"
- noClientExample: true
- /webcapture/{ident}:
- get:
- tags:
- - "webcaptures"
- operationId: "get_webcapture"
- parameters:
- - name: "ident"
- in: "path"
- required: true
- type: "string"
- formatString: "\\\"{}\\\""
- example: "\"ident_example\".to_string()"
- - name: "expand"
- in: "query"
- description: "List of sub-entities to expand in response. For webcaptures,\
- \ `releases` is accepted."
- required: false
- type: "string"
- formatString: "{:?}"
- example: "Some(\"expand_example\".to_string())"
- - name: "hide"
- in: "query"
- description: "List of entity fields to elide in response. For webcaptures,\
- \ 'cdx' is accepted."
- required: false
- type: "string"
- formatString: "{:?}"
- example: "Some(\"hide_example\".to_string())"
- responses:
- 200:
- description: "Found Entity"
- schema:
- $ref: "#/definitions/webcapture_entity"
- x-responseId: "FoundEntity"
- x-uppercaseResponseId: "FOUND_ENTITY"
- uppercase_operation_id: "GET_WEBCAPTURE"
- uppercase_data_type: "WEBCAPTUREENTITY"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "GET_WEBCAPTURE"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "GET_WEBCAPTURE"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "GET_WEBCAPTURE"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- operation_id: "get_webcapture"
- uppercase_operation_id: "GET_WEBCAPTURE"
- path: "/webcapture/:ident"
- HttpMethod: "Get"
- httpmethod: "get"
- /editgroup/{editgroup_id}/webcapture/{ident}:
- put:
- tags:
- - "webcaptures"
- operationId: "update_webcapture"
- parameters:
- - name: "editgroup_id"
- in: "path"
- required: true
- type: "string"
- formatString: "\\\"{}\\\""
- example: "\"editgroup_id_example\".to_string()"
- - name: "ident"
- in: "path"
- required: true
- type: "string"
- formatString: "\\\"{}\\\""
- example: "\"ident_example\".to_string()"
- - in: "body"
- name: "entity"
- required: true
- schema:
- $ref: "#/definitions/webcapture_entity"
- uppercase_data_type: "WEBCAPTUREENTITY"
- refName: "webcapture_entity"
- formatString: "{:?}"
- example: "???"
- model_key: "editgroup_edits"
- uppercase_operation_id: "UPDATE_WEBCAPTURE"
- consumesJson: true
- responses:
- 200:
- description: "Updated Entity"
- schema:
- $ref: "#/definitions/entity_edit"
- x-responseId: "UpdatedEntity"
- x-uppercaseResponseId: "UPDATED_ENTITY"
- uppercase_operation_id: "UPDATE_WEBCAPTURE"
- uppercase_data_type: "ENTITYEDIT"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "UPDATE_WEBCAPTURE"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 401:
- description: "Not Authorized"
- schema:
- $ref: "#/definitions/error_response"
- headers:
- WWW_Authenticate:
- type: "string"
- x-responseId: "NotAuthorized"
- x-uppercaseResponseId: "NOT_AUTHORIZED"
- uppercase_operation_id: "UPDATE_WEBCAPTURE"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 403:
- description: "Forbidden"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "Forbidden"
- x-uppercaseResponseId: "FORBIDDEN"
- uppercase_operation_id: "UPDATE_WEBCAPTURE"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "UPDATE_WEBCAPTURE"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "UPDATE_WEBCAPTURE"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- security:
- - Bearer: []
- operation_id: "update_webcapture"
- uppercase_operation_id: "UPDATE_WEBCAPTURE"
- path: "/editgroup/:editgroup_id/webcapture/:ident"
- HttpMethod: "Put"
- httpmethod: "put"
- noClientExample: true
- delete:
- tags:
- - "webcaptures"
- operationId: "delete_webcapture"
- parameters:
- - name: "editgroup_id"
- in: "path"
- required: true
- type: "string"
- formatString: "\\\"{}\\\""
- example: "\"editgroup_id_example\".to_string()"
- - name: "ident"
- in: "path"
- required: true
- type: "string"
- formatString: "\\\"{}\\\""
- example: "\"ident_example\".to_string()"
- responses:
- 200:
- description: "Deleted Entity"
- schema:
- $ref: "#/definitions/entity_edit"
- x-responseId: "DeletedEntity"
- x-uppercaseResponseId: "DELETED_ENTITY"
- uppercase_operation_id: "DELETE_WEBCAPTURE"
- uppercase_data_type: "ENTITYEDIT"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "DELETE_WEBCAPTURE"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 401:
- description: "Not Authorized"
- schema:
- $ref: "#/definitions/error_response"
- headers:
- WWW_Authenticate:
- type: "string"
- x-responseId: "NotAuthorized"
- x-uppercaseResponseId: "NOT_AUTHORIZED"
- uppercase_operation_id: "DELETE_WEBCAPTURE"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 403:
- description: "Forbidden"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "Forbidden"
- x-uppercaseResponseId: "FORBIDDEN"
- uppercase_operation_id: "DELETE_WEBCAPTURE"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "DELETE_WEBCAPTURE"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "DELETE_WEBCAPTURE"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- security:
- - Bearer: []
- operation_id: "delete_webcapture"
- uppercase_operation_id: "DELETE_WEBCAPTURE"
- path: "/editgroup/:editgroup_id/webcapture/:ident"
- HttpMethod: "Delete"
- httpmethod: "delete"
- /webcapture/rev/{rev_id}:
- get:
- tags:
- - "webcaptures"
- operationId: "get_webcapture_revision"
- parameters:
- - name: "rev_id"
- in: "path"
- description: "UUID (lower-case, dash-separated, hex-encoded 128-bit)"
- required: true
- type: "string"
- maxLength: 36
- minLength: 36
- pattern: "[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}"
- formatString: "\\\"{}\\\""
- example: "\"rev_id_example\".to_string()"
- - name: "expand"
- in: "query"
- description: "List of sub-entities to expand in response. See `get_webcapture`."
- required: false
- type: "string"
- formatString: "{:?}"
- example: "Some(\"expand_example\".to_string())"
- - name: "hide"
- in: "query"
- description: "List of entity fields to elide in response. See `get_webcapture`."
- required: false
- type: "string"
- formatString: "{:?}"
- example: "Some(\"hide_example\".to_string())"
- responses:
- 200:
- description: "Found Entity Revision"
- schema:
- $ref: "#/definitions/webcapture_entity"
- x-responseId: "FoundEntityRevision"
- x-uppercaseResponseId: "FOUND_ENTITY_REVISION"
- uppercase_operation_id: "GET_WEBCAPTURE_REVISION"
- uppercase_data_type: "WEBCAPTUREENTITY"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "GET_WEBCAPTURE_REVISION"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "GET_WEBCAPTURE_REVISION"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "GET_WEBCAPTURE_REVISION"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- operation_id: "get_webcapture_revision"
- uppercase_operation_id: "GET_WEBCAPTURE_REVISION"
- path: "/webcapture/rev/:rev_id"
- HttpMethod: "Get"
- httpmethod: "get"
- /webcapture/{ident}/history:
- get:
- tags:
- - "webcaptures"
- operationId: "get_webcapture_history"
- parameters:
- - name: "ident"
- in: "path"
- required: true
- type: "string"
- formatString: "\\\"{}\\\""
- example: "\"ident_example\".to_string()"
- - name: "limit"
- in: "query"
- required: false
- type: "integer"
- format: "int64"
- formatString: "{:?}"
- example: "Some(789)"
- responses:
- 200:
- description: "Found Entity History"
- schema:
- type: "array"
- items:
- $ref: "#/definitions/entity_history_entry"
- x-responseId: "FoundEntityHistory"
- x-uppercaseResponseId: "FOUND_ENTITY_HISTORY"
- uppercase_operation_id: "GET_WEBCAPTURE_HISTORY"
- uppercase_data_type: "VEC<ENTITYHISTORYENTRY>"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "GET_WEBCAPTURE_HISTORY"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "GET_WEBCAPTURE_HISTORY"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "GET_WEBCAPTURE_HISTORY"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- operation_id: "get_webcapture_history"
- uppercase_operation_id: "GET_WEBCAPTURE_HISTORY"
- path: "/webcapture/:ident/history"
- HttpMethod: "Get"
- httpmethod: "get"
- /webcapture/{ident}/redirects:
- get:
- tags:
- - "webcaptures"
- operationId: "get_webcapture_redirects"
- parameters:
- - name: "ident"
- in: "path"
- required: true
- type: "string"
- formatString: "\\\"{}\\\""
- example: "\"ident_example\".to_string()"
- responses:
- 200:
- description: "Found Entity Redirects"
- schema:
- type: "array"
- items:
- type: "string"
- description: "base32-encoded unique identifier"
- minLength: 26
- maxLength: 26
- pattern: "[a-zA-Z2-7]{26}"
- x-responseId: "FoundEntityRedirects"
- x-uppercaseResponseId: "FOUND_ENTITY_REDIRECTS"
- uppercase_operation_id: "GET_WEBCAPTURE_REDIRECTS"
- uppercase_data_type: "VEC<STRING>"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "GET_WEBCAPTURE_REDIRECTS"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "GET_WEBCAPTURE_REDIRECTS"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "GET_WEBCAPTURE_REDIRECTS"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- operation_id: "get_webcapture_redirects"
- uppercase_operation_id: "GET_WEBCAPTURE_REDIRECTS"
- path: "/webcapture/:ident/redirects"
- HttpMethod: "Get"
- httpmethod: "get"
- /webcapture/edit/{edit_id}:
- get:
- tags:
- - "webcaptures"
- operationId: "get_webcapture_edit"
- parameters:
- - name: "edit_id"
- in: "path"
- description: "UUID (lower-case, dash-separated, hex-encoded 128-bit)"
- required: true
- type: "string"
- maxLength: 36
- minLength: 36
- pattern: "[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}"
- formatString: "\\\"{}\\\""
- example: "\"edit_id_example\".to_string()"
- responses:
- 200:
- description: "Found Edit"
- schema:
- $ref: "#/definitions/entity_edit"
- x-responseId: "FoundEdit"
- x-uppercaseResponseId: "FOUND_EDIT"
- uppercase_operation_id: "GET_WEBCAPTURE_EDIT"
- uppercase_data_type: "ENTITYEDIT"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "GET_WEBCAPTURE_EDIT"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "GET_WEBCAPTURE_EDIT"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "GET_WEBCAPTURE_EDIT"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- operation_id: "get_webcapture_edit"
- uppercase_operation_id: "GET_WEBCAPTURE_EDIT"
- path: "/webcapture/edit/:edit_id"
- HttpMethod: "Get"
- httpmethod: "get"
- /editgroup/{editgroup_id}/webcapture/edit/{edit_id}:
- delete:
- tags:
- - "webcaptures"
- operationId: "delete_webcapture_edit"
- parameters:
- - name: "editgroup_id"
- in: "path"
- required: true
- type: "string"
- formatString: "\\\"{}\\\""
- example: "\"editgroup_id_example\".to_string()"
- - name: "edit_id"
- in: "path"
- description: "UUID (lower-case, dash-separated, hex-encoded 128-bit)"
- required: true
- type: "string"
- maxLength: 36
- minLength: 36
- pattern: "[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}"
- formatString: "\\\"{}\\\""
- example: "\"edit_id_example\".to_string()"
- responses:
- 200:
- description: "Deleted Edit"
- schema:
- $ref: "#/definitions/success"
- x-responseId: "DeletedEdit"
- x-uppercaseResponseId: "DELETED_EDIT"
- uppercase_operation_id: "DELETE_WEBCAPTURE_EDIT"
- uppercase_data_type: "SUCCESS"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "DELETE_WEBCAPTURE_EDIT"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 401:
- description: "Not Authorized"
- schema:
- $ref: "#/definitions/error_response"
- headers:
- WWW_Authenticate:
- type: "string"
- x-responseId: "NotAuthorized"
- x-uppercaseResponseId: "NOT_AUTHORIZED"
- uppercase_operation_id: "DELETE_WEBCAPTURE_EDIT"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 403:
- description: "Forbidden"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "Forbidden"
- x-uppercaseResponseId: "FORBIDDEN"
- uppercase_operation_id: "DELETE_WEBCAPTURE_EDIT"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "DELETE_WEBCAPTURE_EDIT"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "DELETE_WEBCAPTURE_EDIT"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- security:
- - Bearer: []
- operation_id: "delete_webcapture_edit"
- uppercase_operation_id: "DELETE_WEBCAPTURE_EDIT"
- path: "/editgroup/:editgroup_id/webcapture/edit/:edit_id"
- HttpMethod: "Delete"
- httpmethod: "delete"
- /editgroup/{editgroup_id}/release:
- post:
- tags:
- - "releases"
- description: "Create a single Release entity as part of an existing editgroup.\
- \ If the\n`work_id` field is not set, a work entity will be created automatically\n\
- and this field set pointing to the new work.\n\nEditgroup must be mutable\
- \ (aka, not accepted) and editor must have\npermission (aka, have created\
- \ the editgrou p or have `admin` role).\n"
- operationId: "create_release"
- parameters:
- - name: "editgroup_id"
- in: "path"
- required: true
- type: "string"
- formatString: "\\\"{}\\\""
- example: "\"editgroup_id_example\".to_string()"
- - in: "body"
- name: "entity"
- required: true
- schema:
- $ref: "#/definitions/release_entity"
- uppercase_data_type: "RELEASEENTITY"
- refName: "release_entity"
- formatString: "{:?}"
- example: "???"
- model_key: "editgroup_edits"
- uppercase_operation_id: "CREATE_RELEASE"
- consumesJson: true
- responses:
- 201:
- description: "Created Entity"
- schema:
- $ref: "#/definitions/entity_edit"
- x-responseId: "CreatedEntity"
- x-uppercaseResponseId: "CREATED_ENTITY"
- uppercase_operation_id: "CREATE_RELEASE"
- uppercase_data_type: "ENTITYEDIT"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "CREATE_RELEASE"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 401:
- description: "Not Authorized"
- schema:
- $ref: "#/definitions/error_response"
- headers:
- WWW_Authenticate:
- type: "string"
- x-responseId: "NotAuthorized"
- x-uppercaseResponseId: "NOT_AUTHORIZED"
- uppercase_operation_id: "CREATE_RELEASE"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 403:
- description: "Forbidden"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "Forbidden"
- x-uppercaseResponseId: "FORBIDDEN"
- uppercase_operation_id: "CREATE_RELEASE"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "CREATE_RELEASE"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "CREATE_RELEASE"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- security:
- - Bearer: []
- operation_id: "create_release"
- uppercase_operation_id: "CREATE_RELEASE"
- path: "/editgroup/:editgroup_id/release"
- HttpMethod: "Post"
- httpmethod: "post"
- noClientExample: true
- /editgroup/auto/release/batch:
- post:
- tags:
- - "releases"
- description: "Create a set of Release entities as part of a new editgroup, and\n\
- accept that editgroup in the same atomic request.\n\nThis method is mostly\
- \ useful for bulk import of new entities by\ncarefully written bots. This\
- \ method is more efficient than creating an\neditgroup, several entities,\
- \ then accepting the editgroup, both in\nterms of API requests required and\
- \ database load. Requires `admin`\nrole.\n"
- operationId: "create_release_auto_batch"
- parameters:
- - in: "body"
- name: "auto_batch"
- required: true
- schema:
- $ref: "#/definitions/release_auto_batch"
- uppercase_data_type: "RELEASEAUTOBATCH"
- refName: "release_auto_batch"
- formatString: "{:?}"
- example: "???"
- model_key: "editgroup_edits"
- uppercase_operation_id: "CREATE_RELEASE_AUTO_BATCH"
- consumesJson: true
- responses:
- 201:
- description: "Created Editgroup"
- schema:
- $ref: "#/definitions/editgroup"
- x-responseId: "CreatedEditgroup"
- x-uppercaseResponseId: "CREATED_EDITGROUP"
- uppercase_operation_id: "CREATE_RELEASE_AUTO_BATCH"
- uppercase_data_type: "EDITGROUP"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "CREATE_RELEASE_AUTO_BATCH"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 401:
- description: "Not Authorized"
- schema:
- $ref: "#/definitions/error_response"
- headers:
- WWW_Authenticate:
- type: "string"
- x-responseId: "NotAuthorized"
- x-uppercaseResponseId: "NOT_AUTHORIZED"
- uppercase_operation_id: "CREATE_RELEASE_AUTO_BATCH"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 403:
- description: "Forbidden"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "Forbidden"
- x-uppercaseResponseId: "FORBIDDEN"
- uppercase_operation_id: "CREATE_RELEASE_AUTO_BATCH"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "CREATE_RELEASE_AUTO_BATCH"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "CREATE_RELEASE_AUTO_BATCH"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- security:
- - Bearer: []
- operation_id: "create_release_auto_batch"
- uppercase_operation_id: "CREATE_RELEASE_AUTO_BATCH"
- path: "/editgroup/auto/release/batch"
- HttpMethod: "Post"
- httpmethod: "post"
- noClientExample: true
- /release/{ident}:
- get:
- tags:
- - "releases"
- description: "Fetches a single Release entity from the catalog.\n"
- operationId: "get_release"
- parameters:
- - name: "ident"
- in: "path"
- required: true
- type: "string"
- formatString: "\\\"{}\\\""
- example: "\"ident_example\".to_string()"
- - name: "expand"
- in: "query"
- description: "List of sub-entities to expand in response. For releases, 'files',\n\
- 'filesets, 'webcaptures', 'container', and 'creators' are valid.\n"
- required: false
- type: "string"
- formatString: "{:?}"
- example: "Some(\"expand_example\".to_string())"
- - name: "hide"
- in: "query"
- description: "List of entity fields to elide in response (for efficiency).\
- \ For\nreleases, 'abstracts', 'refs', and 'contribs' are valid.\n"
- required: false
- type: "string"
- formatString: "{:?}"
- example: "Some(\"hide_example\".to_string())"
- responses:
- 200:
- description: "Found Entity"
- schema:
- $ref: "#/definitions/release_entity"
- x-responseId: "FoundEntity"
- x-uppercaseResponseId: "FOUND_ENTITY"
- uppercase_operation_id: "GET_RELEASE"
- uppercase_data_type: "RELEASEENTITY"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "GET_RELEASE"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "GET_RELEASE"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "GET_RELEASE"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- operation_id: "get_release"
- uppercase_operation_id: "GET_RELEASE"
- path: "/release/:ident"
- HttpMethod: "Get"
- httpmethod: "get"
- /editgroup/{editgroup_id}/release/{ident}:
- put:
- tags:
- - "releases"
- description: "Updates an existing entity as part of a specific (existing) editgroup.\n\
- The editgroup must be open for updates (aka, not accepted/merged), and\nthe\
- \ editor making the requiest must have permissions (aka, must have\ncreated\
- \ the editgroup or have `admin` role).\n\nThis method can also be used to\
- \ update an existing entity edit as part\nof an editgroup. For example, if\
- \ an entity was created in this\neditgroup, an editor could make changes to\
- \ the new entity's metadata\nbefore merging.\n"
- operationId: "update_release"
- parameters:
- - name: "editgroup_id"
- in: "path"
- required: true
- type: "string"
- formatString: "\\\"{}\\\""
- example: "\"editgroup_id_example\".to_string()"
- - name: "ident"
- in: "path"
- required: true
- type: "string"
- formatString: "\\\"{}\\\""
- example: "\"ident_example\".to_string()"
- - in: "body"
- name: "entity"
- required: true
- schema:
- $ref: "#/definitions/release_entity"
- uppercase_data_type: "RELEASEENTITY"
- refName: "release_entity"
- formatString: "{:?}"
- example: "???"
- model_key: "editgroup_edits"
- uppercase_operation_id: "UPDATE_RELEASE"
- consumesJson: true
- responses:
- 200:
- description: "Updated Entity"
- schema:
- $ref: "#/definitions/entity_edit"
- x-responseId: "UpdatedEntity"
- x-uppercaseResponseId: "UPDATED_ENTITY"
- uppercase_operation_id: "UPDATE_RELEASE"
- uppercase_data_type: "ENTITYEDIT"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "UPDATE_RELEASE"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 401:
- description: "Not Authorized"
- schema:
- $ref: "#/definitions/error_response"
- headers:
- WWW_Authenticate:
- type: "string"
- x-responseId: "NotAuthorized"
- x-uppercaseResponseId: "NOT_AUTHORIZED"
- uppercase_operation_id: "UPDATE_RELEASE"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 403:
- description: "Forbidden"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "Forbidden"
- x-uppercaseResponseId: "FORBIDDEN"
- uppercase_operation_id: "UPDATE_RELEASE"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "UPDATE_RELEASE"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "UPDATE_RELEASE"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- security:
- - Bearer: []
- operation_id: "update_release"
- uppercase_operation_id: "UPDATE_RELEASE"
- path: "/editgroup/:editgroup_id/release/:ident"
- HttpMethod: "Put"
- httpmethod: "put"
- noClientExample: true
- delete:
- tags:
- - "releases"
- description: "Creates a new \"deletion\" edit for a specific entity as part\
- \ of an\nexisting editgroup.\n\nThis is not the method to use to remove an\
- \ edit from an editgroup; for\nthat use `delete_release_edit`.\n"
- operationId: "delete_release"
- parameters:
- - name: "editgroup_id"
- in: "path"
- required: true
- type: "string"
- formatString: "\\\"{}\\\""
- example: "\"editgroup_id_example\".to_string()"
- - name: "ident"
- in: "path"
- required: true
- type: "string"
- formatString: "\\\"{}\\\""
- example: "\"ident_example\".to_string()"
- responses:
- 200:
- description: "Deleted Entity"
- schema:
- $ref: "#/definitions/entity_edit"
- x-responseId: "DeletedEntity"
- x-uppercaseResponseId: "DELETED_ENTITY"
- uppercase_operation_id: "DELETE_RELEASE"
- uppercase_data_type: "ENTITYEDIT"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "DELETE_RELEASE"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 401:
- description: "Not Authorized"
- schema:
- $ref: "#/definitions/error_response"
- headers:
- WWW_Authenticate:
- type: "string"
- x-responseId: "NotAuthorized"
- x-uppercaseResponseId: "NOT_AUTHORIZED"
- uppercase_operation_id: "DELETE_RELEASE"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 403:
- description: "Forbidden"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "Forbidden"
- x-uppercaseResponseId: "FORBIDDEN"
- uppercase_operation_id: "DELETE_RELEASE"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "DELETE_RELEASE"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "DELETE_RELEASE"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- security:
- - Bearer: []
- operation_id: "delete_release"
- uppercase_operation_id: "DELETE_RELEASE"
- path: "/editgroup/:editgroup_id/release/:ident"
- HttpMethod: "Delete"
- httpmethod: "delete"
- /release/rev/{rev_id}:
- get:
- tags:
- - "releases"
- description: "Fetches a specific entity revision. Note that the returned revision\n\
- will not be associated with any particular fatcat identifier (even if\none\
- \ or more identifiers do currently point to this revision). The\nrevision\
- \ may even be part of an un-merged editgroup.\n\nRevisions are immutable and\
- \ can not be deleted or updated.\n"
- operationId: "get_release_revision"
- parameters:
- - name: "rev_id"
- in: "path"
- description: "UUID (lower-case, dash-separated, hex-encoded 128-bit)"
- required: true
- type: "string"
- maxLength: 36
- minLength: 36
- pattern: "[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}"
- formatString: "\\\"{}\\\""
- example: "\"rev_id_example\".to_string()"
- - name: "expand"
- in: "query"
- description: "List of sub-entities to expand in response. See `get_release`,\
- \ though note that identifier-based exapansions like `file` will always\
- \ be empty for revisions."
- required: false
- type: "string"
- formatString: "{:?}"
- example: "Some(\"expand_example\".to_string())"
- - name: "hide"
- in: "query"
- description: "List of entity fields to elide in response. See `get_release`."
- required: false
- type: "string"
- formatString: "{:?}"
- example: "Some(\"hide_example\".to_string())"
- responses:
- 200:
- description: "Found Entity Revision"
- schema:
- $ref: "#/definitions/release_entity"
- x-responseId: "FoundEntityRevision"
- x-uppercaseResponseId: "FOUND_ENTITY_REVISION"
- uppercase_operation_id: "GET_RELEASE_REVISION"
- uppercase_data_type: "RELEASEENTITY"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "GET_RELEASE_REVISION"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "GET_RELEASE_REVISION"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "GET_RELEASE_REVISION"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- operation_id: "get_release_revision"
- uppercase_operation_id: "GET_RELEASE_REVISION"
- path: "/release/rev/:rev_id"
- HttpMethod: "Get"
- httpmethod: "get"
- /release/{ident}/history:
- get:
- tags:
- - "releases"
- description: "Fetches the history of accepted edits (changelog entries) for\
- \ a\nspecific entity fatcat identifier.\n"
- operationId: "get_release_history"
- parameters:
- - name: "ident"
- in: "path"
- required: true
- type: "string"
- formatString: "\\\"{}\\\""
- example: "\"ident_example\".to_string()"
- - name: "limit"
- in: "query"
- required: false
- type: "integer"
- format: "int64"
- formatString: "{:?}"
- example: "Some(789)"
- responses:
- 200:
- description: "Found Entity History"
- schema:
- type: "array"
- items:
- $ref: "#/definitions/entity_history_entry"
- x-responseId: "FoundEntityHistory"
- x-uppercaseResponseId: "FOUND_ENTITY_HISTORY"
- uppercase_operation_id: "GET_RELEASE_HISTORY"
- uppercase_data_type: "VEC<ENTITYHISTORYENTRY>"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "GET_RELEASE_HISTORY"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "GET_RELEASE_HISTORY"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "GET_RELEASE_HISTORY"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- operation_id: "get_release_history"
- uppercase_operation_id: "GET_RELEASE_HISTORY"
- path: "/release/:ident/history"
- HttpMethod: "Get"
- httpmethod: "get"
- /release/{ident}/files:
- get:
- tags:
- - "releases"
- description: "Returns the set of File entities that have a `release_id` pointing\
- \ to\nthis release entity.\n"
- operationId: "get_release_files"
- parameters:
- - name: "ident"
- in: "path"
- required: true
- type: "string"
- formatString: "\\\"{}\\\""
- example: "\"ident_example\".to_string()"
- - name: "hide"
- in: "query"
- description: "List of entity fields to elide in response. See `get_file`."
- required: false
- type: "string"
- formatString: "{:?}"
- example: "Some(\"hide_example\".to_string())"
- responses:
- 200:
- description: "Found"
- schema:
- type: "array"
- items:
- $ref: "#/definitions/file_entity"
- x-responseId: "Found"
- x-uppercaseResponseId: "FOUND"
- uppercase_operation_id: "GET_RELEASE_FILES"
- uppercase_data_type: "VEC<FILEENTITY>"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "GET_RELEASE_FILES"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "GET_RELEASE_FILES"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "GET_RELEASE_FILES"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- operation_id: "get_release_files"
- uppercase_operation_id: "GET_RELEASE_FILES"
- path: "/release/:ident/files"
- HttpMethod: "Get"
- httpmethod: "get"
- /release/{ident}/filesets:
- get:
- tags:
- - "releases"
- description: "Returns the set of Fileset entities that have a `release_id` pointing\
- \ to\nthis release entity.\n"
- operationId: "get_release_filesets"
- parameters:
- - name: "ident"
- in: "path"
- required: true
- type: "string"
- formatString: "\\\"{}\\\""
- example: "\"ident_example\".to_string()"
- - name: "hide"
- in: "query"
- description: "List of entity fields to elide in response. See `get_fileset`."
- required: false
- type: "string"
- formatString: "{:?}"
- example: "Some(\"hide_example\".to_string())"
- responses:
- 200:
- description: "Found"
- schema:
- type: "array"
- items:
- $ref: "#/definitions/fileset_entity"
- x-responseId: "Found"
- x-uppercaseResponseId: "FOUND"
- uppercase_operation_id: "GET_RELEASE_FILESETS"
- uppercase_data_type: "VEC<FILESETENTITY>"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "GET_RELEASE_FILESETS"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "GET_RELEASE_FILESETS"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "GET_RELEASE_FILESETS"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- operation_id: "get_release_filesets"
- uppercase_operation_id: "GET_RELEASE_FILESETS"
- path: "/release/:ident/filesets"
- HttpMethod: "Get"
- httpmethod: "get"
- /release/{ident}/webcaptures:
- get:
- tags:
- - "releases"
- description: "Returns the set of Web Capture entities that have a `release_id`\n\
- pointing to this release entity.\n"
- operationId: "get_release_webcaptures"
- parameters:
- - name: "ident"
- in: "path"
- required: true
- type: "string"
- formatString: "\\\"{}\\\""
- example: "\"ident_example\".to_string()"
- - name: "hide"
- in: "query"
- description: "List of entity fields to elide in response. See `get_webcapture`."
- required: false
- type: "string"
- formatString: "{:?}"
- example: "Some(\"hide_example\".to_string())"
- responses:
- 200:
- description: "Found"
- schema:
- type: "array"
- items:
- $ref: "#/definitions/webcapture_entity"
- x-responseId: "Found"
- x-uppercaseResponseId: "FOUND"
- uppercase_operation_id: "GET_RELEASE_WEBCAPTURES"
- uppercase_data_type: "VEC<WEBCAPTUREENTITY>"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "GET_RELEASE_WEBCAPTURES"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "GET_RELEASE_WEBCAPTURES"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "GET_RELEASE_WEBCAPTURES"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- operation_id: "get_release_webcaptures"
- uppercase_operation_id: "GET_RELEASE_WEBCAPTURES"
- path: "/release/:ident/webcaptures"
- HttpMethod: "Get"
- httpmethod: "get"
- /release/{ident}/redirects:
- get:
- tags:
- - "releases"
- description: "Returns the set of entity identifiers which currently redirect\
- \ to this\nidentifier.\n"
- operationId: "get_release_redirects"
- parameters:
- - name: "ident"
- in: "path"
- required: true
- type: "string"
- formatString: "\\\"{}\\\""
- example: "\"ident_example\".to_string()"
- responses:
- 200:
- description: "Found Entity Redirects"
- schema:
- type: "array"
- items:
- type: "string"
- description: "base32-encoded unique identifier"
- minLength: 26
- maxLength: 26
- pattern: "[a-zA-Z2-7]{26}"
- x-responseId: "FoundEntityRedirects"
- x-uppercaseResponseId: "FOUND_ENTITY_REDIRECTS"
- uppercase_operation_id: "GET_RELEASE_REDIRECTS"
- uppercase_data_type: "VEC<STRING>"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "GET_RELEASE_REDIRECTS"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "GET_RELEASE_REDIRECTS"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "GET_RELEASE_REDIRECTS"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- operation_id: "get_release_redirects"
- uppercase_operation_id: "GET_RELEASE_REDIRECTS"
- path: "/release/:ident/redirects"
- HttpMethod: "Get"
- httpmethod: "get"
- /release/lookup:
- get:
- tags:
- - "releases"
- description: "Looks for an active entity with the given external identifier.\
- \ If any\nsuch entity is found, returns a single complete entity. If multiple\n\
- entities have the same external identifier, this is considered a soft\ncatalog\
- \ error, and the behavior of which entity is returned is\nundefined.\n\nOne\
- \ (and only one) external identifier should be specified per request.\n"
- operationId: "lookup_release"
- parameters:
- - name: "doi"
- in: "query"
- required: false
- type: "string"
- formatString: "{:?}"
- example: "Some(\"doi_example\".to_string())"
- - name: "wikidata_qid"
- in: "query"
- required: false
- type: "string"
- formatString: "{:?}"
- example: "Some(\"wikidata_qid_example\".to_string())"
- - name: "isbn13"
- in: "query"
- required: false
- type: "string"
- formatString: "{:?}"
- example: "Some(\"isbn13_example\".to_string())"
- - name: "pmid"
- in: "query"
- required: false
- type: "string"
- formatString: "{:?}"
- example: "Some(\"pmid_example\".to_string())"
- - name: "pmcid"
- in: "query"
- required: false
- type: "string"
- formatString: "{:?}"
- example: "Some(\"pmcid_example\".to_string())"
- - name: "core"
- in: "query"
- required: false
- type: "string"
- formatString: "{:?}"
- example: "Some(\"core_example\".to_string())"
- - name: "arxiv"
- in: "query"
- required: false
- type: "string"
- formatString: "{:?}"
- example: "Some(\"arxiv_example\".to_string())"
- - name: "jstor"
- in: "query"
- required: false
- type: "string"
- formatString: "{:?}"
- example: "Some(\"jstor_example\".to_string())"
- - name: "ark"
- in: "query"
- required: false
- type: "string"
- formatString: "{:?}"
- example: "Some(\"ark_example\".to_string())"
- - name: "mag"
- in: "query"
- required: false
- type: "string"
- formatString: "{:?}"
- example: "Some(\"mag_example\".to_string())"
- - name: "expand"
- in: "query"
- description: "List of sub-entities to expand in response. See `get_release`."
- required: false
- type: "string"
- formatString: "{:?}"
- example: "Some(\"expand_example\".to_string())"
- - name: "hide"
- in: "query"
- description: "List of sub-entities to elide in response. See `get_release`."
- required: false
- type: "string"
- formatString: "{:?}"
- example: "Some(\"hide_example\".to_string())"
- responses:
- 200:
- description: "Found Entity"
- schema:
- $ref: "#/definitions/release_entity"
- x-responseId: "FoundEntity"
- x-uppercaseResponseId: "FOUND_ENTITY"
- uppercase_operation_id: "LOOKUP_RELEASE"
- uppercase_data_type: "RELEASEENTITY"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "LOOKUP_RELEASE"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "LOOKUP_RELEASE"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "LOOKUP_RELEASE"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- operation_id: "lookup_release"
- uppercase_operation_id: "LOOKUP_RELEASE"
- path: "/release/lookup"
- HttpMethod: "Get"
- httpmethod: "get"
- /release/edit/{edit_id}:
- get:
- tags:
- - "releases"
- description: "Returns the entity edit object with the given identifier. This\
- \ method\nis expected to be used rarely.\n"
- operationId: "get_release_edit"
- parameters:
- - name: "edit_id"
- in: "path"
- description: "UUID (lower-case, dash-separated, hex-encoded 128-bit)"
- required: true
- type: "string"
- maxLength: 36
- minLength: 36
- pattern: "[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}"
- formatString: "\\\"{}\\\""
- example: "\"edit_id_example\".to_string()"
- responses:
- 200:
- description: "Found Edit"
- schema:
- $ref: "#/definitions/entity_edit"
- x-responseId: "FoundEdit"
- x-uppercaseResponseId: "FOUND_EDIT"
- uppercase_operation_id: "GET_RELEASE_EDIT"
- uppercase_data_type: "ENTITYEDIT"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "GET_RELEASE_EDIT"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "GET_RELEASE_EDIT"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "GET_RELEASE_EDIT"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- operation_id: "get_release_edit"
- uppercase_operation_id: "GET_RELEASE_EDIT"
- path: "/release/edit/:edit_id"
- HttpMethod: "Get"
- httpmethod: "get"
- /editgroup/{editgroup_id}/release/edit/{edit_id}:
- delete:
- tags:
- - "releases"
- description: "Removes a single edit from the specified editgroup. The editgroup\
- \ must\nbe mutable (aka, not accepted/merged), and the editor making this\n\
- request must have permission (aka, have created the editgroup or hold\nthe\
- \ `admin` role).\n\nNot to be confused with the `delete_container` method,\
- \ which *creates*\na new edit in the given editgroup.\n"
- operationId: "delete_release_edit"
- parameters:
- - name: "editgroup_id"
- in: "path"
- required: true
- type: "string"
- formatString: "\\\"{}\\\""
- example: "\"editgroup_id_example\".to_string()"
- - name: "edit_id"
- in: "path"
- description: "UUID (lower-case, dash-separated, hex-encoded 128-bit)"
- required: true
- type: "string"
- maxLength: 36
- minLength: 36
- pattern: "[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}"
- formatString: "\\\"{}\\\""
- example: "\"edit_id_example\".to_string()"
- responses:
- 200:
- description: "Deleted Edit"
- schema:
- $ref: "#/definitions/success"
- x-responseId: "DeletedEdit"
- x-uppercaseResponseId: "DELETED_EDIT"
- uppercase_operation_id: "DELETE_RELEASE_EDIT"
- uppercase_data_type: "SUCCESS"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "DELETE_RELEASE_EDIT"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 401:
- description: "Not Authorized"
- schema:
- $ref: "#/definitions/error_response"
- headers:
- WWW_Authenticate:
- type: "string"
- x-responseId: "NotAuthorized"
- x-uppercaseResponseId: "NOT_AUTHORIZED"
- uppercase_operation_id: "DELETE_RELEASE_EDIT"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 403:
- description: "Forbidden"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "Forbidden"
- x-uppercaseResponseId: "FORBIDDEN"
- uppercase_operation_id: "DELETE_RELEASE_EDIT"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "DELETE_RELEASE_EDIT"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "DELETE_RELEASE_EDIT"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- security:
- - Bearer: []
- operation_id: "delete_release_edit"
- uppercase_operation_id: "DELETE_RELEASE_EDIT"
- path: "/editgroup/:editgroup_id/release/edit/:edit_id"
- HttpMethod: "Delete"
- httpmethod: "delete"
- /editgroup/{editgroup_id}/work:
- post:
- tags:
- - "works"
- operationId: "create_work"
- parameters:
- - name: "editgroup_id"
- in: "path"
- required: true
- type: "string"
- formatString: "\\\"{}\\\""
- example: "\"editgroup_id_example\".to_string()"
- - in: "body"
- name: "entity"
- required: true
- schema:
- $ref: "#/definitions/work_entity"
- uppercase_data_type: "WORKENTITY"
- refName: "work_entity"
- formatString: "{:?}"
- example: "???"
- model_key: "editgroup_edits"
- uppercase_operation_id: "CREATE_WORK"
- consumesJson: true
- responses:
- 201:
- description: "Created Entity"
- schema:
- $ref: "#/definitions/entity_edit"
- x-responseId: "CreatedEntity"
- x-uppercaseResponseId: "CREATED_ENTITY"
- uppercase_operation_id: "CREATE_WORK"
- uppercase_data_type: "ENTITYEDIT"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "CREATE_WORK"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 401:
- description: "Not Authorized"
- schema:
- $ref: "#/definitions/error_response"
- headers:
- WWW_Authenticate:
- type: "string"
- x-responseId: "NotAuthorized"
- x-uppercaseResponseId: "NOT_AUTHORIZED"
- uppercase_operation_id: "CREATE_WORK"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 403:
- description: "Forbidden"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "Forbidden"
- x-uppercaseResponseId: "FORBIDDEN"
- uppercase_operation_id: "CREATE_WORK"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "CREATE_WORK"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "CREATE_WORK"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- security:
- - Bearer: []
- operation_id: "create_work"
- uppercase_operation_id: "CREATE_WORK"
- path: "/editgroup/:editgroup_id/work"
- HttpMethod: "Post"
- httpmethod: "post"
- noClientExample: true
- /editgroup/auto/work/batch:
- post:
- tags:
- - "works"
- operationId: "create_work_auto_batch"
- parameters:
- - in: "body"
- name: "auto_batch"
- required: true
- schema:
- $ref: "#/definitions/work_auto_batch"
- uppercase_data_type: "WORKAUTOBATCH"
- refName: "work_auto_batch"
- formatString: "{:?}"
- example: "???"
- model_key: "editgroup_edits"
- uppercase_operation_id: "CREATE_WORK_AUTO_BATCH"
- consumesJson: true
- responses:
- 201:
- description: "Created Editgroup"
- schema:
- $ref: "#/definitions/editgroup"
- x-responseId: "CreatedEditgroup"
- x-uppercaseResponseId: "CREATED_EDITGROUP"
- uppercase_operation_id: "CREATE_WORK_AUTO_BATCH"
- uppercase_data_type: "EDITGROUP"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "CREATE_WORK_AUTO_BATCH"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 401:
- description: "Not Authorized"
- schema:
- $ref: "#/definitions/error_response"
- headers:
- WWW_Authenticate:
- type: "string"
- x-responseId: "NotAuthorized"
- x-uppercaseResponseId: "NOT_AUTHORIZED"
- uppercase_operation_id: "CREATE_WORK_AUTO_BATCH"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 403:
- description: "Forbidden"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "Forbidden"
- x-uppercaseResponseId: "FORBIDDEN"
- uppercase_operation_id: "CREATE_WORK_AUTO_BATCH"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "CREATE_WORK_AUTO_BATCH"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "CREATE_WORK_AUTO_BATCH"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- security:
- - Bearer: []
- operation_id: "create_work_auto_batch"
- uppercase_operation_id: "CREATE_WORK_AUTO_BATCH"
- path: "/editgroup/auto/work/batch"
- HttpMethod: "Post"
- httpmethod: "post"
- noClientExample: true
- /work/{ident}:
- get:
- tags:
- - "works"
- operationId: "get_work"
- parameters:
- - name: "ident"
- in: "path"
- required: true
- type: "string"
- formatString: "\\\"{}\\\""
- example: "\"ident_example\".to_string()"
- - name: "expand"
- in: "query"
- description: "List of sub-entities to expand in response. For works, none\
- \ accepted (yet)."
- required: false
- type: "string"
- formatString: "{:?}"
- example: "Some(\"expand_example\".to_string())"
- - name: "hide"
- in: "query"
- description: "List of entity fields to elide in response. For works, none\
- \ accepted (yet)."
- required: false
- type: "string"
- formatString: "{:?}"
- example: "Some(\"hide_example\".to_string())"
- responses:
- 200:
- description: "Found Entity"
- schema:
- $ref: "#/definitions/work_entity"
- x-responseId: "FoundEntity"
- x-uppercaseResponseId: "FOUND_ENTITY"
- uppercase_operation_id: "GET_WORK"
- uppercase_data_type: "WORKENTITY"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "GET_WORK"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "GET_WORK"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "GET_WORK"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- operation_id: "get_work"
- uppercase_operation_id: "GET_WORK"
- path: "/work/:ident"
- HttpMethod: "Get"
- httpmethod: "get"
- /editgroup/{editgroup_id}/work/{ident}:
- put:
- tags:
- - "works"
- operationId: "update_work"
- parameters:
- - name: "editgroup_id"
- in: "path"
- required: true
- type: "string"
- formatString: "\\\"{}\\\""
- example: "\"editgroup_id_example\".to_string()"
- - name: "ident"
- in: "path"
- required: true
- type: "string"
- formatString: "\\\"{}\\\""
- example: "\"ident_example\".to_string()"
- - in: "body"
- name: "entity"
- required: true
- schema:
- $ref: "#/definitions/work_entity"
- uppercase_data_type: "WORKENTITY"
- refName: "work_entity"
- formatString: "{:?}"
- example: "???"
- model_key: "editgroup_edits"
- uppercase_operation_id: "UPDATE_WORK"
- consumesJson: true
- responses:
- 200:
- description: "Updated Entity"
- schema:
- $ref: "#/definitions/entity_edit"
- x-responseId: "UpdatedEntity"
- x-uppercaseResponseId: "UPDATED_ENTITY"
- uppercase_operation_id: "UPDATE_WORK"
- uppercase_data_type: "ENTITYEDIT"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "UPDATE_WORK"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 401:
- description: "Not Authorized"
- schema:
- $ref: "#/definitions/error_response"
- headers:
- WWW_Authenticate:
- type: "string"
- x-responseId: "NotAuthorized"
- x-uppercaseResponseId: "NOT_AUTHORIZED"
- uppercase_operation_id: "UPDATE_WORK"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 403:
- description: "Forbidden"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "Forbidden"
- x-uppercaseResponseId: "FORBIDDEN"
- uppercase_operation_id: "UPDATE_WORK"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "UPDATE_WORK"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "UPDATE_WORK"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- security:
- - Bearer: []
- operation_id: "update_work"
- uppercase_operation_id: "UPDATE_WORK"
- path: "/editgroup/:editgroup_id/work/:ident"
- HttpMethod: "Put"
- httpmethod: "put"
- noClientExample: true
- delete:
- tags:
- - "works"
- operationId: "delete_work"
- parameters:
- - name: "editgroup_id"
- in: "path"
- required: true
- type: "string"
- formatString: "\\\"{}\\\""
- example: "\"editgroup_id_example\".to_string()"
- - name: "ident"
- in: "path"
- required: true
- type: "string"
- formatString: "\\\"{}\\\""
- example: "\"ident_example\".to_string()"
- responses:
- 200:
- description: "Deleted Entity"
- schema:
- $ref: "#/definitions/entity_edit"
- x-responseId: "DeletedEntity"
- x-uppercaseResponseId: "DELETED_ENTITY"
- uppercase_operation_id: "DELETE_WORK"
- uppercase_data_type: "ENTITYEDIT"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "DELETE_WORK"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 401:
- description: "Not Authorized"
- schema:
- $ref: "#/definitions/error_response"
- headers:
- WWW_Authenticate:
- type: "string"
- x-responseId: "NotAuthorized"
- x-uppercaseResponseId: "NOT_AUTHORIZED"
- uppercase_operation_id: "DELETE_WORK"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 403:
- description: "Forbidden"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "Forbidden"
- x-uppercaseResponseId: "FORBIDDEN"
- uppercase_operation_id: "DELETE_WORK"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "DELETE_WORK"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "DELETE_WORK"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- security:
- - Bearer: []
- operation_id: "delete_work"
- uppercase_operation_id: "DELETE_WORK"
- path: "/editgroup/:editgroup_id/work/:ident"
- HttpMethod: "Delete"
- httpmethod: "delete"
- /work/rev/{rev_id}:
- get:
- tags:
- - "works"
- operationId: "get_work_revision"
- parameters:
- - name: "rev_id"
- in: "path"
- description: "UUID (lower-case, dash-separated, hex-encoded 128-bit)"
- required: true
- type: "string"
- maxLength: 36
- minLength: 36
- pattern: "[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}"
- formatString: "\\\"{}\\\""
- example: "\"rev_id_example\".to_string()"
- - name: "expand"
- in: "query"
- description: "List of sub-entities to expand in response. See `get_work`,\
- \ though note that identifier-based expansions like `releases` will always\
- \ be empty for revisions."
- required: false
- type: "string"
- formatString: "{:?}"
- example: "Some(\"expand_example\".to_string())"
- - name: "hide"
- in: "query"
- description: "List of entity fields to elide in response. See `get_work`."
- required: false
- type: "string"
- formatString: "{:?}"
- example: "Some(\"hide_example\".to_string())"
- responses:
- 200:
- description: "Found Entity Revision"
- schema:
- $ref: "#/definitions/work_entity"
- x-responseId: "FoundEntityRevision"
- x-uppercaseResponseId: "FOUND_ENTITY_REVISION"
- uppercase_operation_id: "GET_WORK_REVISION"
- uppercase_data_type: "WORKENTITY"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "GET_WORK_REVISION"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "GET_WORK_REVISION"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "GET_WORK_REVISION"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- operation_id: "get_work_revision"
- uppercase_operation_id: "GET_WORK_REVISION"
- path: "/work/rev/:rev_id"
- HttpMethod: "Get"
- httpmethod: "get"
- /work/{ident}/history:
- get:
- tags:
- - "works"
- operationId: "get_work_history"
- parameters:
- - name: "ident"
- in: "path"
- required: true
- type: "string"
- formatString: "\\\"{}\\\""
- example: "\"ident_example\".to_string()"
- - name: "limit"
- in: "query"
- required: false
- type: "integer"
- format: "int64"
- formatString: "{:?}"
- example: "Some(789)"
- responses:
- 200:
- description: "Found Entity History"
- schema:
- type: "array"
- items:
- $ref: "#/definitions/entity_history_entry"
- x-responseId: "FoundEntityHistory"
- x-uppercaseResponseId: "FOUND_ENTITY_HISTORY"
- uppercase_operation_id: "GET_WORK_HISTORY"
- uppercase_data_type: "VEC<ENTITYHISTORYENTRY>"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "GET_WORK_HISTORY"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "GET_WORK_HISTORY"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "GET_WORK_HISTORY"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- operation_id: "get_work_history"
- uppercase_operation_id: "GET_WORK_HISTORY"
- path: "/work/:ident/history"
- HttpMethod: "Get"
- httpmethod: "get"
- /work/{ident}/redirects:
- get:
- tags:
- - "works"
- operationId: "get_work_redirects"
- parameters:
- - name: "ident"
- in: "path"
- required: true
- type: "string"
- formatString: "\\\"{}\\\""
- example: "\"ident_example\".to_string()"
- responses:
- 200:
- description: "Found Entity Redirects"
- schema:
- type: "array"
- items:
- type: "string"
- description: "base32-encoded unique identifier"
- minLength: 26
- maxLength: 26
- pattern: "[a-zA-Z2-7]{26}"
- x-responseId: "FoundEntityRedirects"
- x-uppercaseResponseId: "FOUND_ENTITY_REDIRECTS"
- uppercase_operation_id: "GET_WORK_REDIRECTS"
- uppercase_data_type: "VEC<STRING>"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "GET_WORK_REDIRECTS"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "GET_WORK_REDIRECTS"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "GET_WORK_REDIRECTS"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- operation_id: "get_work_redirects"
- uppercase_operation_id: "GET_WORK_REDIRECTS"
- path: "/work/:ident/redirects"
- HttpMethod: "Get"
- httpmethod: "get"
- /work/{ident}/releases:
- get:
- tags:
- - "works"
- description: "Returns the set of release entities that are part of this work\
- \ (aka,\nhave `work_id` pointing to this work entity).\n"
- operationId: "get_work_releases"
- parameters:
- - name: "ident"
- in: "path"
- required: true
- type: "string"
- formatString: "\\\"{}\\\""
- example: "\"ident_example\".to_string()"
- - name: "hide"
- in: "query"
- description: "List of entity fields to elide in response. See `get_release`."
- required: false
- type: "string"
- formatString: "{:?}"
- example: "Some(\"hide_example\".to_string())"
- responses:
- 200:
- description: "Found"
- schema:
- type: "array"
- items:
- $ref: "#/definitions/release_entity"
- x-responseId: "Found"
- x-uppercaseResponseId: "FOUND"
- uppercase_operation_id: "GET_WORK_RELEASES"
- uppercase_data_type: "VEC<RELEASEENTITY>"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "GET_WORK_RELEASES"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "GET_WORK_RELEASES"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "GET_WORK_RELEASES"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- operation_id: "get_work_releases"
- uppercase_operation_id: "GET_WORK_RELEASES"
- path: "/work/:ident/releases"
- HttpMethod: "Get"
- httpmethod: "get"
- /work/edit/{edit_id}:
- get:
- tags:
- - "works"
- operationId: "get_work_edit"
- parameters:
- - name: "edit_id"
- in: "path"
- description: "UUID (lower-case, dash-separated, hex-encoded 128-bit)"
- required: true
- type: "string"
- maxLength: 36
- minLength: 36
- pattern: "[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}"
- formatString: "\\\"{}\\\""
- example: "\"edit_id_example\".to_string()"
- responses:
- 200:
- description: "Found Edit"
- schema:
- $ref: "#/definitions/entity_edit"
- x-responseId: "FoundEdit"
- x-uppercaseResponseId: "FOUND_EDIT"
- uppercase_operation_id: "GET_WORK_EDIT"
- uppercase_data_type: "ENTITYEDIT"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "GET_WORK_EDIT"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "GET_WORK_EDIT"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "GET_WORK_EDIT"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- operation_id: "get_work_edit"
- uppercase_operation_id: "GET_WORK_EDIT"
- path: "/work/edit/:edit_id"
- HttpMethod: "Get"
- httpmethod: "get"
- /editgroup/{editgroup_id}/work/edit/{edit_id}:
- delete:
- tags:
- - "works"
- operationId: "delete_work_edit"
- parameters:
- - name: "editgroup_id"
- in: "path"
- required: true
- type: "string"
- formatString: "\\\"{}\\\""
- example: "\"editgroup_id_example\".to_string()"
- - name: "edit_id"
- in: "path"
- description: "UUID (lower-case, dash-separated, hex-encoded 128-bit)"
- required: true
- type: "string"
- maxLength: 36
- minLength: 36
- pattern: "[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}"
- formatString: "\\\"{}\\\""
- example: "\"edit_id_example\".to_string()"
- responses:
- 200:
- description: "Deleted Edit"
- schema:
- $ref: "#/definitions/success"
- x-responseId: "DeletedEdit"
- x-uppercaseResponseId: "DELETED_EDIT"
- uppercase_operation_id: "DELETE_WORK_EDIT"
- uppercase_data_type: "SUCCESS"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "DELETE_WORK_EDIT"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 401:
- description: "Not Authorized"
- schema:
- $ref: "#/definitions/error_response"
- headers:
- WWW_Authenticate:
- type: "string"
- x-responseId: "NotAuthorized"
- x-uppercaseResponseId: "NOT_AUTHORIZED"
- uppercase_operation_id: "DELETE_WORK_EDIT"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 403:
- description: "Forbidden"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "Forbidden"
- x-uppercaseResponseId: "FORBIDDEN"
- uppercase_operation_id: "DELETE_WORK_EDIT"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "DELETE_WORK_EDIT"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "DELETE_WORK_EDIT"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- security:
- - Bearer: []
- operation_id: "delete_work_edit"
- uppercase_operation_id: "DELETE_WORK_EDIT"
- path: "/editgroup/:editgroup_id/work/edit/:edit_id"
- HttpMethod: "Delete"
- httpmethod: "delete"
- /editor/{editor_id}:
- get:
- tags:
- - "editors"
- description: "Returns an editor object, including metadata such as the username,\n\
- type, and role of editor.\n"
- operationId: "get_editor"
- parameters:
- - name: "editor_id"
- in: "path"
- required: true
- type: "string"
- formatString: "\\\"{}\\\""
- example: "\"editor_id_example\".to_string()"
- responses:
- 200:
- description: "Found"
- schema:
- $ref: "#/definitions/editor"
- x-responseId: "Found"
- x-uppercaseResponseId: "FOUND"
- uppercase_operation_id: "GET_EDITOR"
- uppercase_data_type: "EDITOR"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "GET_EDITOR"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "GET_EDITOR"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "GET_EDITOR"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- operation_id: "get_editor"
- uppercase_operation_id: "GET_EDITOR"
- path: "/editor/:editor_id"
- HttpMethod: "Get"
- httpmethod: "get"
- put:
- tags:
- - "editors"
- description: "Allows metadata changes to some editor fields, such as the username.\n\
- \nChanges require authentication and permissions. An editor can change\ntheir\
- \ own username; changes to role flags require the `admin` role by\nthe editor\
- \ making the request.\n"
- operationId: "update_editor"
- parameters:
- - name: "editor_id"
- in: "path"
- required: true
- type: "string"
- formatString: "\\\"{}\\\""
- example: "\"editor_id_example\".to_string()"
- - in: "body"
- name: "editor"
- required: true
- schema:
- $ref: "#/definitions/editor"
- uppercase_data_type: "EDITOR"
- refName: "editor"
- formatString: "{:?}"
- example: "???"
- model_key: "editgroup_edits"
- uppercase_operation_id: "UPDATE_EDITOR"
- consumesJson: true
- responses:
- 200:
- description: "Updated Editor"
- schema:
- $ref: "#/definitions/editor"
- x-responseId: "UpdatedEditor"
- x-uppercaseResponseId: "UPDATED_EDITOR"
- uppercase_operation_id: "UPDATE_EDITOR"
- uppercase_data_type: "EDITOR"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "UPDATE_EDITOR"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 401:
- description: "Not Authorized"
- schema:
- $ref: "#/definitions/error_response"
- headers:
- WWW_Authenticate:
- type: "string"
- x-responseId: "NotAuthorized"
- x-uppercaseResponseId: "NOT_AUTHORIZED"
- uppercase_operation_id: "UPDATE_EDITOR"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 403:
- description: "Forbidden"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "Forbidden"
- x-uppercaseResponseId: "FORBIDDEN"
- uppercase_operation_id: "UPDATE_EDITOR"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "UPDATE_EDITOR"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "UPDATE_EDITOR"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- security:
- - Bearer: []
- operation_id: "update_editor"
- uppercase_operation_id: "UPDATE_EDITOR"
- path: "/editor/:editor_id"
- HttpMethod: "Put"
- httpmethod: "put"
- noClientExample: true
- /editor/{editor_id}/editgroups:
- get:
- tags:
- - "editors"
- description: "Returns a set of editgroups created by the given editor, regardless\
- \ of\nthe status (accepted/submitted) of the editgroups.\n"
- operationId: "get_editor_editgroups"
- parameters:
- - name: "editor_id"
- in: "path"
- required: true
- type: "string"
- formatString: "\\\"{}\\\""
- example: "\"editor_id_example\".to_string()"
- - name: "limit"
- in: "query"
- required: false
- type: "integer"
- format: "int64"
- formatString: "{:?}"
- example: "Some(789)"
- - name: "before"
- in: "query"
- description: "Return only editgroups created *before* the given timestamp\
- \ (not\ninclusive). Editgroups will be sorted by creation time in\ndescending\
- \ order (most recent first). For use in pagination.\n"
- required: false
- type: "string"
- format: "date-time"
- formatString: "{:?}"
- example: "None"
- - name: "since"
- in: "query"
- description: "Return only editgroups created *after* the given timestamp (not\n\
- inclusive). Editgroups will be sorted by creation time in ascending\norder\
- \ (most recent last). For use in pagination.\n"
- required: false
- type: "string"
- format: "date-time"
- formatString: "{:?}"
- example: "None"
- responses:
- 200:
- description: "Found"
- schema:
- type: "array"
- items:
- $ref: "#/definitions/editgroup"
- x-responseId: "Found"
- x-uppercaseResponseId: "FOUND"
- uppercase_operation_id: "GET_EDITOR_EDITGROUPS"
- uppercase_data_type: "VEC<EDITGROUP>"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "GET_EDITOR_EDITGROUPS"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "GET_EDITOR_EDITGROUPS"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "GET_EDITOR_EDITGROUPS"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- operation_id: "get_editor_editgroups"
- uppercase_operation_id: "GET_EDITOR_EDITGROUPS"
- path: "/editor/:editor_id/editgroups"
- HttpMethod: "Get"
- httpmethod: "get"
- /editor/{editor_id}/annotations:
- get:
- tags:
- - "editors"
- description: "Fetches a list of annotations made by a particular editor.\n"
- operationId: "get_editor_annotations"
- parameters:
- - name: "editor_id"
- in: "path"
- description: "base32-encoded unique identifier"
- required: true
- type: "string"
- maxLength: 26
- minLength: 26
- pattern: "[a-zA-Z2-7]{26}"
- formatString: "\\\"{}\\\""
- example: "\"editor_id_example\".to_string()"
- - name: "limit"
- in: "query"
- description: "Maximum number (count) of annotations to return in response"
- required: false
- type: "integer"
- format: "int64"
- formatString: "{:?}"
- example: "Some(789)"
- - name: "before"
- in: "query"
- description: "Return only annotations made *before* the given timestamp (not\n\
- inclusive). Annotations will be sorted by creation time in\ndescending order\
- \ (most recent first). For use in pagination.\n"
- required: false
- type: "string"
- format: "date-time"
- formatString: "{:?}"
- example: "None"
- - name: "since"
- in: "query"
- description: "Return only annotations made *after* the given timestamp (not\n\
- inclusive). Annotations will be sorted by creation time in\nascending order\
- \ (most recent last). For use in pagination.\n"
- required: false
- type: "string"
- format: "date-time"
- formatString: "{:?}"
- example: "None"
- responses:
- 200:
- description: "Success"
- schema:
- type: "array"
- items:
- $ref: "#/definitions/editgroup_annotation"
- x-responseId: "Success"
- x-uppercaseResponseId: "SUCCESS"
- uppercase_operation_id: "GET_EDITOR_ANNOTATIONS"
- uppercase_data_type: "VEC<EDITGROUPANNOTATION>"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "GET_EDITOR_ANNOTATIONS"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 401:
- description: "Not Authorized"
- schema:
- $ref: "#/definitions/error_response"
- headers:
- WWW_Authenticate:
- type: "string"
- x-responseId: "NotAuthorized"
- x-uppercaseResponseId: "NOT_AUTHORIZED"
- uppercase_operation_id: "GET_EDITOR_ANNOTATIONS"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 403:
- description: "Forbidden"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "Forbidden"
- x-uppercaseResponseId: "FORBIDDEN"
- uppercase_operation_id: "GET_EDITOR_ANNOTATIONS"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "GET_EDITOR_ANNOTATIONS"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "GET_EDITOR_ANNOTATIONS"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- operation_id: "get_editor_annotations"
- uppercase_operation_id: "GET_EDITOR_ANNOTATIONS"
- path: "/editor/:editor_id/annotations"
- HttpMethod: "Get"
- httpmethod: "get"
- /editgroup:
- post:
- tags:
- - "editgroups"
- description: "Creates a new editgroup. By default the editor making this request\
- \ will\nbe the author of the editgroup.\n"
- operationId: "create_editgroup"
- parameters:
- - in: "body"
- name: "editgroup"
- required: true
- schema:
- $ref: "#/definitions/editgroup"
- uppercase_data_type: "EDITGROUP"
- refName: "editgroup"
- formatString: "{:?}"
- example: "???"
- model_key: "editgroup_edits"
- uppercase_operation_id: "CREATE_EDITGROUP"
- consumesJson: true
- responses:
- 201:
- description: "Successfully Created"
- schema:
- $ref: "#/definitions/editgroup"
- x-responseId: "SuccessfullyCreated"
- x-uppercaseResponseId: "SUCCESSFULLY_CREATED"
- uppercase_operation_id: "CREATE_EDITGROUP"
- uppercase_data_type: "EDITGROUP"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "CREATE_EDITGROUP"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 401:
- description: "Not Authorized"
- schema:
- $ref: "#/definitions/error_response"
- headers:
- WWW_Authenticate:
- type: "string"
- x-responseId: "NotAuthorized"
- x-uppercaseResponseId: "NOT_AUTHORIZED"
- uppercase_operation_id: "CREATE_EDITGROUP"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 403:
- description: "Forbidden"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "Forbidden"
- x-uppercaseResponseId: "FORBIDDEN"
- uppercase_operation_id: "CREATE_EDITGROUP"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "CREATE_EDITGROUP"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "CREATE_EDITGROUP"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- security:
- - Bearer: []
- operation_id: "create_editgroup"
- uppercase_operation_id: "CREATE_EDITGROUP"
- path: "/editgroup"
- HttpMethod: "Post"
- httpmethod: "post"
- noClientExample: true
- /editgroup/{editgroup_id}:
- get:
- tags:
- - "editgroups"
- description: "Returns a single editgroup object.\n\nUnlike some similar methods,\
- \ this method will return a full/expanded\neditgroup object, which includes\
- \ edit lists of each entity type (though\nwill not include the complete entity\
- \ objects).\n"
- operationId: "get_editgroup"
- parameters:
- - name: "editgroup_id"
- in: "path"
- description: "base32-encoded unique identifier"
- required: true
- type: "string"
- maxLength: 26
- minLength: 26
- pattern: "[a-zA-Z2-7]{26}"
- formatString: "\\\"{}\\\""
- example: "\"editgroup_id_example\".to_string()"
- responses:
- 200:
- description: "Found"
- schema:
- $ref: "#/definitions/editgroup"
- x-responseId: "Found"
- x-uppercaseResponseId: "FOUND"
- uppercase_operation_id: "GET_EDITGROUP"
- uppercase_data_type: "EDITGROUP"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "GET_EDITGROUP"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "GET_EDITGROUP"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "GET_EDITGROUP"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- operation_id: "get_editgroup"
- uppercase_operation_id: "GET_EDITGROUP"
- path: "/editgroup/:editgroup_id"
- HttpMethod: "Get"
- httpmethod: "get"
- put:
- tags:
- - "editgroups"
- description: "Updates metadata for a single editgroup object. Note that only\
- \ metadata\nfields such as the `description` or `extra` metadata can be changed\n\
- with this method; it does not allow adding or removing edits to the\neditgroup\
- \ (for that use the individual entity create/update/delete\nmethods).\n"
- operationId: "update_editgroup"
- parameters:
- - name: "editgroup_id"
- in: "path"
- description: "base32-encoded unique identifier"
- required: true
- type: "string"
- maxLength: 26
- minLength: 26
- pattern: "[a-zA-Z2-7]{26}"
- formatString: "\\\"{}\\\""
- example: "\"editgroup_id_example\".to_string()"
- - in: "body"
- name: "editgroup"
- required: true
- schema:
- $ref: "#/definitions/editgroup"
- uppercase_data_type: "EDITGROUP"
- refName: "editgroup"
- formatString: "{:?}"
- example: "???"
- model_key: "editgroup_edits"
- uppercase_operation_id: "UPDATE_EDITGROUP"
- consumesJson: true
- - name: "submit"
- in: "query"
- required: false
- type: "boolean"
- formatString: "{:?}"
- example: "Some(true)"
- responses:
- 200:
- description: "Updated Editgroup"
- schema:
- $ref: "#/definitions/editgroup"
- x-responseId: "UpdatedEditgroup"
- x-uppercaseResponseId: "UPDATED_EDITGROUP"
- uppercase_operation_id: "UPDATE_EDITGROUP"
- uppercase_data_type: "EDITGROUP"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "UPDATE_EDITGROUP"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 401:
- description: "Not Authorized"
- schema:
- $ref: "#/definitions/error_response"
- headers:
- WWW_Authenticate:
- type: "string"
- x-responseId: "NotAuthorized"
- x-uppercaseResponseId: "NOT_AUTHORIZED"
- uppercase_operation_id: "UPDATE_EDITGROUP"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 403:
- description: "Forbidden"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "Forbidden"
- x-uppercaseResponseId: "FORBIDDEN"
- uppercase_operation_id: "UPDATE_EDITGROUP"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "UPDATE_EDITGROUP"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "UPDATE_EDITGROUP"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- security:
- - Bearer: []
- operation_id: "update_editgroup"
- uppercase_operation_id: "UPDATE_EDITGROUP"
- path: "/editgroup/:editgroup_id"
- HttpMethod: "Put"
- httpmethod: "put"
- noClientExample: true
- /editgroup/{editgroup_id}/accept:
- post:
- tags:
- - "editgroups"
- description: "Accept (\"merge\") the given editgroup into the catalog. The editgroup\n\
- must be open (not already accepted), and the editor making this request\n\
- must have the `admin` role.\n"
- operationId: "accept_editgroup"
- parameters:
- - name: "editgroup_id"
- in: "path"
- description: "base32-encoded unique identifier"
- required: true
- type: "string"
- maxLength: 26
- minLength: 26
- pattern: "[a-zA-Z2-7]{26}"
- formatString: "\\\"{}\\\""
- example: "\"editgroup_id_example\".to_string()"
- responses:
- 200:
- description: "Merged Successfully"
- schema:
- $ref: "#/definitions/success"
- x-responseId: "MergedSuccessfully"
- x-uppercaseResponseId: "MERGED_SUCCESSFULLY"
- uppercase_operation_id: "ACCEPT_EDITGROUP"
- uppercase_data_type: "SUCCESS"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "ACCEPT_EDITGROUP"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 401:
- description: "Not Authorized"
- schema:
- $ref: "#/definitions/error_response"
- headers:
- WWW_Authenticate:
- type: "string"
- x-responseId: "NotAuthorized"
- x-uppercaseResponseId: "NOT_AUTHORIZED"
- uppercase_operation_id: "ACCEPT_EDITGROUP"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 403:
- description: "Forbidden"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "Forbidden"
- x-uppercaseResponseId: "FORBIDDEN"
- uppercase_operation_id: "ACCEPT_EDITGROUP"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "ACCEPT_EDITGROUP"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 409:
- description: "Edit Conflict"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "EditConflict"
- x-uppercaseResponseId: "EDIT_CONFLICT"
- uppercase_operation_id: "ACCEPT_EDITGROUP"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "ACCEPT_EDITGROUP"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- security:
- - Bearer: []
- operation_id: "accept_editgroup"
- uppercase_operation_id: "ACCEPT_EDITGROUP"
- path: "/editgroup/:editgroup_id/accept"
- HttpMethod: "Post"
- httpmethod: "post"
- /editgroup/{editgroup_id}/annotations:
- get:
- tags:
- - "editgroups"
- description: "Returns a list of annotations made to a specific editgroup."
- operationId: "get_editgroup_annotations"
- parameters:
- - name: "editgroup_id"
- in: "path"
- description: "base32-encoded unique identifier"
- required: true
- type: "string"
- maxLength: 26
- minLength: 26
- pattern: "[a-zA-Z2-7]{26}"
- formatString: "\\\"{}\\\""
- example: "\"editgroup_id_example\".to_string()"
- - name: "expand"
- in: "query"
- description: "List of sub-entities to expand in response. For editgroup annotations:\
- \ 'editors'"
- required: false
- type: "string"
- formatString: "{:?}"
- example: "Some(\"expand_example\".to_string())"
- responses:
- 200:
- description: "Success"
- schema:
- type: "array"
- items:
- $ref: "#/definitions/editgroup_annotation"
- x-responseId: "Success"
- x-uppercaseResponseId: "SUCCESS"
- uppercase_operation_id: "GET_EDITGROUP_ANNOTATIONS"
- uppercase_data_type: "VEC<EDITGROUPANNOTATION>"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "GET_EDITGROUP_ANNOTATIONS"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 401:
- description: "Not Authorized"
- schema:
- $ref: "#/definitions/error_response"
- headers:
- WWW_Authenticate:
- type: "string"
- x-responseId: "NotAuthorized"
- x-uppercaseResponseId: "NOT_AUTHORIZED"
- uppercase_operation_id: "GET_EDITGROUP_ANNOTATIONS"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 403:
- description: "Forbidden"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "Forbidden"
- x-uppercaseResponseId: "FORBIDDEN"
- uppercase_operation_id: "GET_EDITGROUP_ANNOTATIONS"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "GET_EDITGROUP_ANNOTATIONS"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "GET_EDITGROUP_ANNOTATIONS"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- operation_id: "get_editgroup_annotations"
- uppercase_operation_id: "GET_EDITGROUP_ANNOTATIONS"
- path: "/editgroup/:editgroup_id/annotations"
- HttpMethod: "Get"
- httpmethod: "get"
- /editgroup/{editgroup_id}/annotation:
- post:
- tags:
- - "editgroups"
- description: "Submits a new annotation to the specified editgroup.\n\nThe editgroup\
- \ must be open (not already accepted). The annotation will\nautomatically\
- \ have authorship of the editor making this request.\n"
- operationId: "create_editgroup_annotation"
- parameters:
- - name: "editgroup_id"
- in: "path"
- description: "base32-encoded unique identifier"
- required: true
- type: "string"
- maxLength: 26
- minLength: 26
- pattern: "[a-zA-Z2-7]{26}"
- formatString: "\\\"{}\\\""
- example: "\"editgroup_id_example\".to_string()"
- - in: "body"
- name: "annotation"
- required: true
- schema:
- $ref: "#/definitions/editgroup_annotation"
- uppercase_data_type: "EDITGROUPANNOTATION"
- refName: "editgroup_annotation"
- formatString: "{:?}"
- example: "???"
- model_key: "editgroup_edits"
- uppercase_operation_id: "CREATE_EDITGROUP_ANNOTATION"
- consumesJson: true
- responses:
- 201:
- description: "Created"
- schema:
- $ref: "#/definitions/editgroup_annotation"
- x-responseId: "Created"
- x-uppercaseResponseId: "CREATED"
- uppercase_operation_id: "CREATE_EDITGROUP_ANNOTATION"
- uppercase_data_type: "EDITGROUPANNOTATION"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "CREATE_EDITGROUP_ANNOTATION"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 401:
- description: "Not Authorized"
- schema:
- $ref: "#/definitions/error_response"
- headers:
- WWW_Authenticate:
- type: "string"
- x-responseId: "NotAuthorized"
- x-uppercaseResponseId: "NOT_AUTHORIZED"
- uppercase_operation_id: "CREATE_EDITGROUP_ANNOTATION"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 403:
- description: "Forbidden"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "Forbidden"
- x-uppercaseResponseId: "FORBIDDEN"
- uppercase_operation_id: "CREATE_EDITGROUP_ANNOTATION"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "CREATE_EDITGROUP_ANNOTATION"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "CREATE_EDITGROUP_ANNOTATION"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- security:
- - Bearer: []
- operation_id: "create_editgroup_annotation"
- uppercase_operation_id: "CREATE_EDITGROUP_ANNOTATION"
- path: "/editgroup/:editgroup_id/annotation"
- HttpMethod: "Post"
- httpmethod: "post"
- noClientExample: true
- /editgroup/reviewable:
- get:
- tags:
- - "editgroups"
- description: "Returns a set of editgroups which have been submitted but not\
- \ yet accepted.\n\nQuery parameters can be used to sort and paginate the list\
- \ returned.\n"
- operationId: "get_editgroups_reviewable"
- parameters:
- - name: "expand"
- in: "query"
- description: "List of sub-entities to expand in response. For editgroups:\
- \ 'editors'"
- required: false
- type: "string"
- formatString: "{:?}"
- example: "Some(\"expand_example\".to_string())"
- - name: "limit"
- in: "query"
- description: "Maximum number of reviewable editgroups to return in response"
- required: false
- type: "integer"
- format: "int64"
- formatString: "{:?}"
- example: "Some(789)"
- - name: "before"
- in: "query"
- description: "Return only reviewable editgroups submitted *before* the given\n\
- timestamp (not inclusive). Editgroups will be sorted by submission\ntime\
- \ in descending order (most recent first). For use in pagination.\n"
- required: false
- type: "string"
- format: "date-time"
- formatString: "{:?}"
- example: "None"
- - name: "since"
- in: "query"
- description: "Return only reviewable editgroups submitted *after* the given\n\
- timestamp (not inclusive). Editgroups will be sorted by submission\ntime\
- \ in ascending order (most recent last). For use in pagination.\n"
- required: false
- type: "string"
- format: "date-time"
- formatString: "{:?}"
- example: "None"
- responses:
- 200:
- description: "Found"
- schema:
- type: "array"
- items:
- $ref: "#/definitions/editgroup"
- x-responseId: "Found"
- x-uppercaseResponseId: "FOUND"
- uppercase_operation_id: "GET_EDITGROUPS_REVIEWABLE"
- uppercase_data_type: "VEC<EDITGROUP>"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "GET_EDITGROUPS_REVIEWABLE"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "GET_EDITGROUPS_REVIEWABLE"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "GET_EDITGROUPS_REVIEWABLE"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- operation_id: "get_editgroups_reviewable"
- uppercase_operation_id: "GET_EDITGROUPS_REVIEWABLE"
- path: "/editgroup/reviewable"
- HttpMethod: "Get"
- httpmethod: "get"
- /changelog:
- get:
- tags:
- - "changelog"
- description: "Returns a list of the most recent changelog entries accepted (merged)\n\
- into the catalog.\n\nList is sorted by changelog index in descending order.\
- \ Note that the\naccepted timestamp roughly corresponds to order, but not\
- \ strictly;\nthere exist out-of-order timestamps on the order of several seconds.\n\
- \nAs a known database issue, it is technically possible for there to be a\n\
- gap in changelog index numbers (aka, a missing changelog entry). There\nare\
- \ no currently known gaps and this is considered a bug that will be\naddressed.\n\
- \nThere are millions of entries; to paginate through all of them, use\nthis\
- \ method to discover the highest existing entry number, then request\nthe\
- \ entries using `get_changelog_entry` one at a time.\n"
- operationId: "get_changelog"
- parameters:
- - name: "limit"
- in: "query"
- description: "Maximum count of changelog entries to return in response"
- required: false
- type: "integer"
- format: "int64"
- formatString: "{:?}"
- example: "Some(789)"
- responses:
- 200:
- description: "Success"
- schema:
- type: "array"
- items:
- $ref: "#/definitions/changelog_entry"
- x-responseId: "Success"
- x-uppercaseResponseId: "SUCCESS"
- uppercase_operation_id: "GET_CHANGELOG"
- uppercase_data_type: "VEC<CHANGELOGENTRY>"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "GET_CHANGELOG"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "GET_CHANGELOG"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- operation_id: "get_changelog"
- uppercase_operation_id: "GET_CHANGELOG"
- path: "/changelog"
- HttpMethod: "Get"
- httpmethod: "get"
- /changelog/{index}:
- get:
- tags:
- - "changelog"
- description: "Returns a single changelog entry.\n\nAs a known database issue,\
- \ it is technically possible for there to be a\ngap in changelog index numbers\
- \ (aka, a missing changelog entry). There\nare no currently known gaps and\
- \ this is considered a bug that will be\naddressed.\n"
- operationId: "get_changelog_entry"
- parameters:
- - name: "index"
- in: "path"
- description: "Changelog index of entry to return"
- required: true
- type: "integer"
- format: "int64"
- formatString: "{}"
- example: "789"
- responses:
- 200:
- description: "Found Changelog Entry"
- schema:
- $ref: "#/definitions/changelog_entry"
- x-responseId: "FoundChangelogEntry"
- x-uppercaseResponseId: "FOUND_CHANGELOG_ENTRY"
- uppercase_operation_id: "GET_CHANGELOG_ENTRY"
- uppercase_data_type: "CHANGELOGENTRY"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "GET_CHANGELOG_ENTRY"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "NotFound"
- x-uppercaseResponseId: "NOT_FOUND"
- uppercase_operation_id: "GET_CHANGELOG_ENTRY"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "GET_CHANGELOG_ENTRY"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- operation_id: "get_changelog_entry"
- uppercase_operation_id: "GET_CHANGELOG_ENTRY"
- path: "/changelog/:index"
- HttpMethod: "Get"
- httpmethod: "get"
- /auth/oidc:
- post:
- tags:
- - "auth"
- description: "Login or create editor account using OIDC metadata (internal method).\n\
- \nThis method is used by privileged front-end tools (like the web\ninterface\
- \ service) to process editor logins using OpenID Connect (OIDC)\nand/or OAuth.\
- \ Most accounts (including tool and bot accounts) do not\nhave sufficient\
- \ privileges to call this method, which requires the\n`admin` role.\n\nThe\
- \ method returns an API token; the HTTP status code indicates whether\nan\
- \ existing account was logged in, or a new account was created.\n"
- operationId: "auth_oidc"
- parameters:
- - in: "body"
- name: "oidc_params"
- required: true
- schema:
- $ref: "#/definitions/auth_oidc"
- uppercase_data_type: "AUTHOIDC"
- refName: "auth_oidc"
- formatString: "{:?}"
- example: "???"
- model_key: "editgroup_edits"
- uppercase_operation_id: "AUTH_OIDC"
- consumesJson: true
- responses:
- 200:
- description: "Found"
- schema:
- $ref: "#/definitions/auth_oidc_result"
- x-responseId: "Found"
- x-uppercaseResponseId: "FOUND"
- uppercase_operation_id: "AUTH_OIDC"
- uppercase_data_type: "AUTHOIDCRESULT"
- producesJson: true
- 201:
- description: "Created"
- schema:
- $ref: "#/definitions/auth_oidc_result"
- x-responseId: "Created"
- x-uppercaseResponseId: "CREATED"
- uppercase_operation_id: "AUTH_OIDC"
- uppercase_data_type: "AUTHOIDCRESULT"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "AUTH_OIDC"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 401:
- description: "Not Authorized"
- schema:
- $ref: "#/definitions/error_response"
- headers:
- WWW_Authenticate:
- type: "string"
- x-responseId: "NotAuthorized"
- x-uppercaseResponseId: "NOT_AUTHORIZED"
- uppercase_operation_id: "AUTH_OIDC"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 403:
- description: "Forbidden"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "Forbidden"
- x-uppercaseResponseId: "FORBIDDEN"
- uppercase_operation_id: "AUTH_OIDC"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 409:
- description: "Conflict"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "Conflict"
- x-uppercaseResponseId: "CONFLICT"
- uppercase_operation_id: "AUTH_OIDC"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "AUTH_OIDC"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- security:
- - Bearer: []
- operation_id: "auth_oidc"
- uppercase_operation_id: "AUTH_OIDC"
- path: "/auth/oidc"
- HttpMethod: "Post"
- httpmethod: "post"
- noClientExample: true
- /auth/check:
- get:
- tags:
- - "auth"
- description: "Verify that authentication (API token) is working as expected.\
- \ The\noptional `role` parameter can be used to verify that the current\n\
- account (editor) has permissions for the given role.\n"
- operationId: "auth_check"
- parameters:
- - name: "role"
- in: "query"
- required: false
- type: "string"
- formatString: "{:?}"
- example: "Some(\"role_example\".to_string())"
- responses:
- 200:
- description: "Success"
- schema:
- $ref: "#/definitions/success"
- x-responseId: "Success"
- x-uppercaseResponseId: "SUCCESS"
- uppercase_operation_id: "AUTH_CHECK"
- uppercase_data_type: "SUCCESS"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "AUTH_CHECK"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 401:
- description: "Not Authorized"
- schema:
- $ref: "#/definitions/error_response"
- headers:
- WWW_Authenticate:
- type: "string"
- x-responseId: "NotAuthorized"
- x-uppercaseResponseId: "NOT_AUTHORIZED"
- uppercase_operation_id: "AUTH_CHECK"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 403:
- description: "Forbidden"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "Forbidden"
- x-uppercaseResponseId: "FORBIDDEN"
- uppercase_operation_id: "AUTH_CHECK"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "AUTH_CHECK"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- security:
- - Bearer: []
- operation_id: "auth_check"
- uppercase_operation_id: "AUTH_CHECK"
- path: "/auth/check"
- HttpMethod: "Get"
- httpmethod: "get"
- /auth/token/{editor_id}:
- post:
- tags:
- - "auth"
- description: "Generate a new auth token for a given editor (internal method).\n\
- \nThis method is used by the web interface to generate API tokens for\nusers.\
- \ It can not be called by editors (human or bot) to generate new\ntokens for\
- \ themselves, at least at this time.\n"
- operationId: "create_auth_token"
- parameters:
- - name: "editor_id"
- in: "path"
- required: true
- type: "string"
- formatString: "\\\"{}\\\""
- example: "\"editor_id_example\".to_string()"
- - name: "duration_seconds"
- in: "query"
- description: "How long API token should be valid for (in seconds)"
- required: false
- type: "integer"
- formatString: "{:?}"
- example: "Some(56)"
- responses:
- 200:
- description: "Success"
- schema:
- $ref: "#/definitions/auth_token_result"
- x-responseId: "Success"
- x-uppercaseResponseId: "SUCCESS"
- uppercase_operation_id: "CREATE_AUTH_TOKEN"
- uppercase_data_type: "AUTHTOKENRESULT"
- producesJson: true
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "BadRequest"
- x-uppercaseResponseId: "BAD_REQUEST"
- uppercase_operation_id: "CREATE_AUTH_TOKEN"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 401:
- description: "Not Authorized"
- schema:
- $ref: "#/definitions/error_response"
- headers:
- WWW_Authenticate:
- type: "string"
- x-responseId: "NotAuthorized"
- x-uppercaseResponseId: "NOT_AUTHORIZED"
- uppercase_operation_id: "CREATE_AUTH_TOKEN"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 403:
- description: "Forbidden"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "Forbidden"
- x-uppercaseResponseId: "FORBIDDEN"
- uppercase_operation_id: "CREATE_AUTH_TOKEN"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"
- x-responseId: "GenericError"
- x-uppercaseResponseId: "GENERIC_ERROR"
- uppercase_operation_id: "CREATE_AUTH_TOKEN"
- uppercase_data_type: "ERRORRESPONSE"
- producesJson: true
- security:
- - Bearer: []
- operation_id: "create_auth_token"
- uppercase_operation_id: "CREATE_AUTH_TOKEN"
- path: "/auth/token/:editor_id"
- HttpMethod: "Post"
- httpmethod: "post"
-securityDefinitions:
- Bearer:
- description: "The only current API authentication mechanism is HTTP bearer\nauthentication\
- \ using the `Authorization` HTTP header. The header should\nbe formatted as\
- \ the string \"Bearer\", then a space, then API token (in the\nusual base64\
- \ string encoding).\n\nAn example HTTP request would look on the wire like:\n\
- \n GET /v0/auth/check HTTP/1.1\n Accept: */*\n Accept-Encoding: gzip,\
- \ deflate\n Authorization: Bearer AgEPZGV2LmZhdGNhdC53aWtpAhYyMDE5MDEwMS1kZXYtZHVtbXkta2V5AAImZWRpdG9yX2lkID0gYWFhYWFhYWFhYWFhYmt2a2FhYWFhYWFhYWkAAht0aW1lID4gMjAxOS0wMS0wOVQwMDo1Nzo1MloAAAYgnroNha1hSftChtxHGTnLEmM/pY8MeQS/jBSV0UNvXug=\n\
- \ Connection: keep-alive\n Host: api.qa.fatcat.wiki\n User-Agent: HTTPie/0.9.8\n\
- \nHeaders can be passed on the command line using `http` (HTTPie) like:\n\n\
- \ http get https://api.qa.fatcat.wiki/v0/auth/check Authorization:\"Bearer\
- \ AgEPZGV2LmZhdGNhdC53aWtpAhYyMDE5MDEwMS1kZXYtZHVtbXkta2V5AAImZWRpdG9yX2lkID0gYWFhYWFhYWFhYWFhYmt2a2FhYWFhYWFhYWkAAht0aW1lID4gMjAxOS0wMS0wOVQwMDo1Nzo1MloAAAYgnroNha1hSftChtxHGTnLEmM/pY8MeQS/jBSV0UNvXug=\"\
- \n\nOr with `curl`:\n\n curl -H \"Authorization: Bearer AgEPZGV2LmZhdGNhdC53aWtpAhYyMDE5MDEwMS1kZXYtZHVtbXkta2V5AAImZWRpdG9yX2lkID0gYWFhYWFhYWFhYWFhYmt2a2FhYWFhYWFhYWkAAht0aW1lID4gMjAxOS0wMS0wOVQwMDo1Nzo1MloAAAYgnroNha1hSftChtxHGTnLEmM/pY8MeQS/jBSV0UNvXug=\"\
- \ https://qa.fatcat.wiki/v0/auth/check\n"
- type: "apiKey"
- name: "Authorization"
- in: "header"
-definitions:
- error_response:
- type: "object"
- required:
- - "error"
- - "message"
- - "success"
- properties:
- success:
- type: "boolean"
- example: false
- error:
- type: "string"
- example: "unexpected-thing"
- message:
- type: "string"
- example: "A really confusing, totally unexpected thing happened"
- upperCaseName: "ERROR_RESPONSE"
- success:
- type: "object"
- required:
- - "message"
- - "success"
- properties:
- success:
- type: "boolean"
- example: true
- message:
- type: "string"
- example: "The computers did the thing successfully!"
- example:
- success: true
- message: "The computers did the thing successfully!"
- upperCaseName: "SUCCESS"
- container_entity:
- type: "object"
- properties:
- wikidata_qid:
- type: "string"
- example: "Q42812"
- issnl:
- type: "string"
- example: "1234-5678"
- description: "Linking ISSN number (ISSN-L). Should be valid and registered\
- \ with issn.org"
- minLength: 9
- maxLength: 9
- pattern: "\\d{4}-\\d{3}[0-9X]"
- publisher:
- type: "string"
- example: "Society of Curious Students"
- description: "Name of the organization or entity responsible for publication.\
- \ Not\nthe complete imprint/brand.\n"
- container_type:
- type: "string"
- example: "journal"
- description: "Type of container, eg 'journal' or 'proceedings'. See Guide\
- \ for list of valid types."
- name:
- type: "string"
- example: "Journal of Important Results"
- description: "Name of the container (eg, Journal title). Required for entity\
- \ creation."
- edit_extra:
- type: "object"
- description: "Free-form JSON metadata that will be stored with specific entity\
- \ edits\n(eg, creation/update/delete).\n"
- extra:
- type: "object"
- description: "Free-form JSON metadata that will be stored with the other entity\n\
- metadata. See guide for (unenforced) schema conventions.\n"
- redirect:
- type: "string"
- example: "q3nouwy3nnbsvo3h5klxsx4a7y"
- description: "base32-encoded unique identifier"
- minLength: 26
- maxLength: 26
- pattern: "[a-zA-Z2-7]{26}"
- revision:
- type: "string"
- example: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- description: "UUID (lower-case, dash-separated, hex-encoded 128-bit)"
- minLength: 36
- maxLength: 36
- pattern: "[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}"
- ident:
- type: "string"
- example: "q3nouwy3nnbsvo3h5klxsx4a7y"
- description: "base32-encoded unique identifier"
- minLength: 26
- maxLength: 26
- pattern: "[a-zA-Z2-7]{26}"
- state:
- type: "string"
- example: "active"
- enum:
- - "wip"
- - "active"
- - "redirect"
- - "deleted"
- example:
- redirect: "q3nouwy3nnbsvo3h5klxsx4a7y"
- ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- extra: "{}"
- container_type: "journal"
- name: "Journal of Important Results"
- publisher: "Society of Curious Students"
- issnl: "1234-5678"
- wikidata_qid: "Q42812"
- state: "active"
- edit_extra: "{}"
- revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- upperCaseName: "CONTAINER_ENTITY"
- creator_entity:
- type: "object"
- properties:
- wikidata_qid:
- type: "string"
- example: "Q42812"
- description: "Wikidata entity QID"
- orcid:
- type: "string"
- example: "0000-0002-1825-0097"
- description: "ORCiD (https://orcid.org) identifier"
- minLength: 19
- maxLength: 19
- pattern: "\\d{4}-\\d{4}-\\d{4}-\\d{3}[\\dX]"
- surname:
- type: "string"
- description: "In English commonly the last, or family name, but ordering is\
- \ context\nand culture specific.\n"
- given_name:
- type: "string"
- description: "In English commonly the first name, but ordering is context\
- \ and\nculture specific.\n"
- display_name:
- type: "string"
- example: "Grace Hopper"
- description: "Name as should be displayed in web interface or in author lists\
- \ (not\nindex/sorted). Required for valid entities.\n"
- state:
- type: "string"
- example: "active"
- enum:
- - "wip"
- - "active"
- - "redirect"
- - "deleted"
- ident:
- type: "string"
- example: "q3nouwy3nnbsvo3h5klxsx4a7y"
- description: "base32-encoded unique identifier"
- minLength: 26
- maxLength: 26
- pattern: "[a-zA-Z2-7]{26}"
- revision:
- type: "string"
- example: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- description: "UUID (lower-case, dash-separated, hex-encoded 128-bit)"
- minLength: 36
- maxLength: 36
- pattern: "[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}"
- redirect:
- type: "string"
- example: "q3nouwy3nnbsvo3h5klxsx4a7y"
- description: "base32-encoded unique identifier"
- minLength: 26
- maxLength: 26
- pattern: "[a-zA-Z2-7]{26}"
- extra:
- type: "object"
- description: "Free-form JSON metadata that will be stored with the other entity\n\
- metadata. See guide for (unenforced) schema conventions.\n"
- edit_extra:
- type: "object"
- description: "Free-form JSON metadata that will be stored with specific entity\
- \ edits\n(eg, creation/update/delete).\n"
- example:
- redirect: "q3nouwy3nnbsvo3h5klxsx4a7y"
- surname: "surname"
- ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- extra: "{}"
- orcid: "0000-0002-1825-0097"
- wikidata_qid: "Q42812"
- state: "active"
- given_name: "given_name"
- display_name: "Grace Hopper"
- edit_extra: "{}"
- revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- upperCaseName: "CREATOR_ENTITY"
- file_entity:
- type: "object"
- properties:
- releases:
- type: "array"
- description: "Full release entities, included in GET responses when `releases`\n\
- included in `expand` parameter. Ignored if included in PUT or POST\nrequests.\n"
- items:
- $ref: "#/definitions/release_entity"
- release_ids:
- type: "array"
- description: "Set of identifier of release entities this file represents a\
- \ full\nmanifestation of. Usually a single release, but some files contain\n\
- content of multiple full releases (eg, an issue of a journal).\n"
- items:
- type: "string"
- example: "q3nouwy3nnbsvo3h5klxsx4a7y"
- description: "base32-encoded unique identifier"
- minLength: 26
- maxLength: 26
- pattern: "[a-zA-Z2-7]{26}"
- mimetype:
- type: "string"
- example: "application/pdf"
- urls:
- type: "array"
- items:
- $ref: "#/definitions/file_url"
- sha256:
- type: "string"
- example: "cb1c378f464d5935ddaa8de28446d82638396c61f042295d7fb85e3cccc9e452"
- description: "SHA-256 hash of data, in hex encoding"
- minLength: 64
- maxLength: 64
- pattern: "[a-f0-9]{64}"
- sha1:
- type: "string"
- example: "e9dd75237c94b209dc3ccd52722de6931a310ba3"
- description: "SHA-1 hash of data, in hex encoding"
- minLength: 40
- maxLength: 40
- pattern: "[a-f0-9]{40}"
- md5:
- type: "string"
- example: "1b39813549077b2347c0f370c3864b40"
- description: "MD5 hash of data, in hex encoding"
- minLength: 32
- maxLength: 32
- pattern: "[a-f0-9]{32}"
- size:
- type: "integer"
- format: "int64"
- example: 1048576
- description: "Size of file in bytes. Non-zero."
- edit_extra:
- type: "object"
- description: "Free-form JSON metadata that will be stored with specific entity\
- \ edits\n(eg, creation/update/delete).\n"
- extra:
- type: "object"
- description: "Free-form JSON metadata that will be stored with the other entity\n\
- metadata. See guide for (unenforced) schema conventions.\n"
- redirect:
- type: "string"
- example: "q3nouwy3nnbsvo3h5klxsx4a7y"
- description: "base32-encoded unique identifier"
- minLength: 26
- maxLength: 26
- pattern: "[a-zA-Z2-7]{26}"
- revision:
- type: "string"
- example: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- description: "UUID (lower-case, dash-separated, hex-encoded 128-bit)"
- minLength: 36
- maxLength: 36
- pattern: "[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}"
- ident:
- type: "string"
- example: "q3nouwy3nnbsvo3h5klxsx4a7y"
- description: "base32-encoded unique identifier"
- minLength: 26
- maxLength: 26
- pattern: "[a-zA-Z2-7]{26}"
- state:
- type: "string"
- example: "active"
- enum:
- - "wip"
- - "active"
- - "redirect"
- - "deleted"
- example:
- redirect: "q3nouwy3nnbsvo3h5klxsx4a7y"
- sha256: "cb1c378f464d5935ddaa8de28446d82638396c61f042295d7fb85e3cccc9e452"
- ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- releases:
- - null
- - null
- revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- sha1: "e9dd75237c94b209dc3ccd52722de6931a310ba3"
- urls:
- - rel: "web"
- url: "https://example.edu/~frau/prcding.pdf"
- - rel: "web"
- url: "https://example.edu/~frau/prcding.pdf"
- size: 1048576
- extra: "{}"
- mimetype: "application/pdf"
- state: "active"
- release_ids:
- - "q3nouwy3nnbsvo3h5klxsx4a7y"
- - "q3nouwy3nnbsvo3h5klxsx4a7y"
- edit_extra: "{}"
- md5: "1b39813549077b2347c0f370c3864b40"
- upperCaseName: "FILE_ENTITY"
- file_url:
- type: "object"
- required:
- - "rel"
- - "url"
- properties:
- url:
- type: "string"
- format: "url"
- example: "https://example.edu/~frau/prcding.pdf"
- description: "URL/URI pointing directly to a machine retrievable copy of this\
- \ exact\nfile.\n"
- rel:
- type: "string"
- example: "web"
- description: "Indicates type of host this URL points to. Eg, \"publisher\"\
- ,\n\"repository\", \"webarchive\". See guide for list of acceptable values.\n"
- example:
- rel: "web"
- url: "https://example.edu/~frau/prcding.pdf"
- upperCaseName: "FILE_URL"
- fileset_entity:
- type: "object"
- properties:
- releases:
- type: "array"
- description: "Full release entities, included in GET responses when `releases`\n\
- included in `expand` parameter. Ignored if included in PUT or POST\nrequests.\n"
- items:
- $ref: "#/definitions/release_entity"
- release_ids:
- type: "array"
- description: "Set of identifier of release entities this fileset represents\
- \ a full\nmanifestation of. Usually a single release.\n"
- items:
- type: "string"
- example: "q3nouwy3nnbsvo3h5klxsx4a7y"
- description: "base32-encoded unique identifier"
- minLength: 26
- maxLength: 26
- pattern: "[a-zA-Z2-7]{26}"
- urls:
- type: "array"
- items:
- $ref: "#/definitions/fileset_url"
- manifest:
- type: "array"
- items:
- $ref: "#/definitions/fileset_file"
- state:
- type: "string"
- example: "active"
- enum:
- - "wip"
- - "active"
- - "redirect"
- - "deleted"
- ident:
- type: "string"
- example: "q3nouwy3nnbsvo3h5klxsx4a7y"
- description: "base32-encoded unique identifier"
- minLength: 26
- maxLength: 26
- pattern: "[a-zA-Z2-7]{26}"
- revision:
- type: "string"
- example: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- description: "UUID (lower-case, dash-separated, hex-encoded 128-bit)"
- minLength: 36
- maxLength: 36
- pattern: "[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}"
- redirect:
- type: "string"
- example: "q3nouwy3nnbsvo3h5klxsx4a7y"
- description: "base32-encoded unique identifier"
- minLength: 26
- maxLength: 26
- pattern: "[a-zA-Z2-7]{26}"
- extra:
- type: "object"
- description: "Free-form JSON metadata that will be stored with the other entity\n\
- metadata. See guide for (unenforced) schema conventions.\n"
- edit_extra:
- type: "object"
- description: "Free-form JSON metadata that will be stored with specific entity\
- \ edits\n(eg, creation/update/delete).\n"
- example:
- redirect: "q3nouwy3nnbsvo3h5klxsx4a7y"
- urls:
- - rel: "webarchive"
- url: "https://example.edu/~frau/prcding.pdf"
- - rel: "webarchive"
- url: "https://example.edu/~frau/prcding.pdf"
- manifest:
- - sha1: "e9dd75237c94b209dc3ccd52722de6931a310ba3"
- path: "img/cat.png"
- size: 1048576
- sha256: "cb1c378f464d5935ddaa8de28446d82638396c61f042295d7fb85e3cccc9e452"
- extra: "{}"
- md5: "1b39813549077b2347c0f370c3864b40"
- - sha1: "e9dd75237c94b209dc3ccd52722de6931a310ba3"
- path: "img/cat.png"
- size: 1048576
- sha256: "cb1c378f464d5935ddaa8de28446d82638396c61f042295d7fb85e3cccc9e452"
- extra: "{}"
- md5: "1b39813549077b2347c0f370c3864b40"
- ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- extra: "{}"
- state: "active"
- release_ids:
- - "q3nouwy3nnbsvo3h5klxsx4a7y"
- - "q3nouwy3nnbsvo3h5klxsx4a7y"
- edit_extra: "{}"
- releases:
- - null
- - null
- revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- upperCaseName: "FILESET_ENTITY"
- fileset_url:
- type: "object"
- required:
- - "rel"
- - "url"
- properties:
- url:
- type: "string"
- format: "url"
- example: "https://example.edu/~frau/prcding.pdf"
- rel:
- type: "string"
- example: "webarchive"
- description: "Indicates type of host this URL points to. See guide for list\
- \ of\nacceptable values.\n"
- example:
- rel: "webarchive"
- url: "https://example.edu/~frau/prcding.pdf"
- upperCaseName: "FILESET_URL"
- fileset_file:
- type: "object"
- required:
- - "path"
- - "size"
- properties:
- path:
- type: "string"
- example: "img/cat.png"
- description: "Path name of file within this fileset (eg, directory)\n"
- size:
- type: "integer"
- format: "int64"
- example: 1048576
- description: "File size in bytes"
- md5:
- type: "string"
- example: "1b39813549077b2347c0f370c3864b40"
- description: "MD5 hash of data, in hex encoding"
- minLength: 32
- maxLength: 32
- pattern: "[a-f0-9]{32}"
- sha1:
- type: "string"
- example: "e9dd75237c94b209dc3ccd52722de6931a310ba3"
- description: "SHA-1 hash of data, in hex encoding"
- minLength: 40
- maxLength: 40
- pattern: "[a-f0-9]{40}"
- sha256:
- type: "string"
- example: "cb1c378f464d5935ddaa8de28446d82638396c61f042295d7fb85e3cccc9e452"
- description: "SHA-256 hash of data, in hex encoding"
- minLength: 64
- maxLength: 64
- pattern: "[a-f0-9]{64}"
- extra:
- type: "object"
- description: "Free-form additional metadata about this specific file in the\
- \ set.\nEg, `mimetype`. See guide for nomative (but unenforced) schema\n\
- fields.\n"
- example:
- sha1: "e9dd75237c94b209dc3ccd52722de6931a310ba3"
- path: "img/cat.png"
- size: 1048576
- sha256: "cb1c378f464d5935ddaa8de28446d82638396c61f042295d7fb85e3cccc9e452"
- extra: "{}"
- md5: "1b39813549077b2347c0f370c3864b40"
- upperCaseName: "FILESET_FILE"
- webcapture_entity:
- type: "object"
- properties:
- releases:
- type: "array"
- description: "Full release entities, included in GET responses when `releases`\n\
- included in `expand` parameter. Ignored if included in PUT or POST\nrequests.\n"
- items:
- $ref: "#/definitions/release_entity"
- release_ids:
- type: "array"
- description: "Set of identifier of release entities this fileset represents\
- \ a full\nmanifestation of. Usually a single release.\n"
- items:
- type: "string"
- example: "q3nouwy3nnbsvo3h5klxsx4a7y"
- description: "base32-encoded unique identifier"
- minLength: 26
- maxLength: 26
- pattern: "[a-zA-Z2-7]{26}"
- timestamp:
- type: "string"
- format: "date-time"
- description: "Same format as CDX line timestamp (UTC, etc). Corresponds to\
- \ the\noverall capture timestamp. Should generally be the timestamp of\n\
- capture of the primary resource URL.\n"
- original_url:
- type: "string"
- format: "url"
- example: "http://asheesh.org"
- description: "Base URL of the primary resource this is a capture of"
- archive_urls:
- type: "array"
- items:
- $ref: "#/definitions/webcapture_url"
- cdx:
- type: "array"
- items:
- $ref: "#/definitions/webcapture_cdx_line"
- edit_extra:
- type: "object"
- description: "Free-form JSON metadata that will be stored with specific entity\
- \ edits\n(eg, creation/update/delete).\n"
- extra:
- type: "object"
- description: "Free-form JSON metadata that will be stored with the other entity\n\
- metadata. See guide for (unenforced) schema conventions.\n"
- redirect:
- type: "string"
- example: "q3nouwy3nnbsvo3h5klxsx4a7y"
- description: "base32-encoded unique identifier"
- minLength: 26
- maxLength: 26
- pattern: "[a-zA-Z2-7]{26}"
- revision:
- type: "string"
- example: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- description: "UUID (lower-case, dash-separated, hex-encoded 128-bit)"
- minLength: 36
- maxLength: 36
- pattern: "[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}"
- ident:
- type: "string"
- example: "q3nouwy3nnbsvo3h5klxsx4a7y"
- description: "base32-encoded unique identifier"
- minLength: 26
- maxLength: 26
- pattern: "[a-zA-Z2-7]{26}"
- state:
- type: "string"
- example: "active"
- enum:
- - "wip"
- - "active"
- - "redirect"
- - "deleted"
- example:
- redirect: "q3nouwy3nnbsvo3h5klxsx4a7y"
- archive_urls:
- - rel: "wayback"
- url: "https://web.archive.org/web/"
- - rel: "wayback"
- url: "https://web.archive.org/web/"
- original_url: "http://asheesh.org"
- cdx:
- - sha1: "e9dd75237c94b209dc3ccd52722de6931a310ba3"
- surt: "org,asheesh)/apus/ch1/node15.html"
- status_code: 200
- size: 1048576
- sha256: "cb1c378f464d5935ddaa8de28446d82638396c61f042295d7fb85e3cccc9e452"
- mimetype: "text/html"
- url: "http://www.asheesh.org:80/APUS/ch1/node15.html"
- timestamp: "2016-09-19T17:20:24Z"
- - sha1: "e9dd75237c94b209dc3ccd52722de6931a310ba3"
- surt: "org,asheesh)/apus/ch1/node15.html"
- status_code: 200
- size: 1048576
- sha256: "cb1c378f464d5935ddaa8de28446d82638396c61f042295d7fb85e3cccc9e452"
- mimetype: "text/html"
- url: "http://www.asheesh.org:80/APUS/ch1/node15.html"
- timestamp: "2016-09-19T17:20:24Z"
- ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- extra: "{}"
- state: "active"
- release_ids:
- - "q3nouwy3nnbsvo3h5klxsx4a7y"
- - "q3nouwy3nnbsvo3h5klxsx4a7y"
- edit_extra: "{}"
- releases:
- - null
- - null
- timestamp: "2000-01-23T04:56:07.000+00:00"
- revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- upperCaseName: "WEBCAPTURE_ENTITY"
- webcapture_cdx_line:
- type: "object"
- required:
- - "sha1"
- - "surt"
- - "timestamp"
- - "url"
- properties:
- surt:
- type: "string"
- example: "org,asheesh)/apus/ch1/node15.html"
- description: "\"Sortable URL\" format. See guide for details.\n"
- timestamp:
- type: "string"
- format: "date-time"
- example: "2016-09-19T17:20:24Z"
- description: "Date and time of capture, in ISO format. UTC, 'Z'-terminated,\
- \ second\n(or better) precision.\n"
- url:
- type: "string"
- example: "http://www.asheesh.org:80/APUS/ch1/node15.html"
- description: "Full URL/URI of resource captured.\n"
- mimetype:
- type: "string"
- example: "text/html"
- description: "Mimetype of the resource at this URL. May be the Content-Type\
- \ header,\nor the actually sniffed file type.\n"
- status_code:
- type: "integer"
- format: "int64"
- example: 200
- description: "HTTP status code. Should generally be 200, especially for the\
- \ primary\nresource, but may be 3xx (redirect) or even error codes if embedded\n\
- resources can not be fetched successfully.\n"
- size:
- type: "integer"
- format: "int64"
- example: 1048576
- description: "Resource (file) size in bytes"
- sha1:
- type: "string"
- example: "e9dd75237c94b209dc3ccd52722de6931a310ba3"
- description: "SHA-1 hash of data, in hex encoding"
- minLength: 40
- maxLength: 40
- pattern: "[a-f0-9]{40}"
- sha256:
- type: "string"
- example: "cb1c378f464d5935ddaa8de28446d82638396c61f042295d7fb85e3cccc9e452"
- description: "SHA-256 hash of data, in hex encoding"
- minLength: 64
- maxLength: 64
- pattern: "[a-f0-9]{64}"
- example:
- sha1: "e9dd75237c94b209dc3ccd52722de6931a310ba3"
- surt: "org,asheesh)/apus/ch1/node15.html"
- status_code: 200
- size: 1048576
- sha256: "cb1c378f464d5935ddaa8de28446d82638396c61f042295d7fb85e3cccc9e452"
- mimetype: "text/html"
- url: "http://www.asheesh.org:80/APUS/ch1/node15.html"
- timestamp: "2016-09-19T17:20:24Z"
- upperCaseName: "WEBCAPTURE_CDX_LINE"
- webcapture_url:
- type: "object"
- required:
- - "rel"
- - "url"
- properties:
- url:
- type: "string"
- format: "url"
- example: "https://web.archive.org/web/"
- description: "URL/URI pointing to archive of this web resource.\n"
- rel:
- type: "string"
- example: "wayback"
- description: "Type of archive endpoint. Usually `wayback` (WBM replay of primary\n\
- resource), or `warc` (direct URL to a WARC file containing all\nresources\
- \ of the capture). See guide for full list.\n"
- example:
- rel: "wayback"
- url: "https://web.archive.org/web/"
- upperCaseName: "WEBCAPTURE_URL"
- release_entity:
- type: "object"
- required:
- - "ext_ids"
- properties:
- abstracts:
- type: "array"
- items:
- $ref: "#/definitions/release_abstract"
- refs:
- type: "array"
- items:
- $ref: "#/definitions/release_ref"
- contribs:
- type: "array"
- items:
- $ref: "#/definitions/release_contrib"
- license_slug:
- type: "string"
- example: "CC-BY"
- description: "Short string (slug) name of license under which release is openly\n\
- published (if applicable).\n"
- language:
- type: "string"
- example: "en"
- description: "Primary language of the content of the full release. Two-letter\n\
- RFC1766/ISO639-1 language code, with some custom\nextensions/additions.\
- \ See guide.\n"
- publisher:
- type: "string"
- example: "Elsevier"
- description: "Name, usually English, of the entity or institution responsible\
- \ for\npublication of this release. Not necessarily the imprint/brand. See\n\
- guide.\n"
- version:
- type: "string"
- example: "3"
- description: "For, eg, updated technical reports or software packages, where\n\
- the version string may be the only field disambiguating between\nreleases.\n"
- number:
- type: "string"
- example: "RFC1337"
- description: "For, eg, technical reports, which are published in series or\n\
- assigned some other institutional or container-specific identifier.\n"
- pages:
- type: "string"
- example: "340-345"
- description: "Either a single page number (\"first page\") or a range of pages\n\
- separated by a dash (\"-\"). See guide for details.\n"
- issue:
- type: "string"
- example: "12"
- description: "Issue number of volume/container that this release was published\
- \ in.\nSometimes coresponds to a month number in the year, but can be any\n\
- string. See guide.\n"
- volume:
- type: "string"
- example: "3"
- description: "Volume number of container that this release was published in.\
- \ Often\ncorresponds to the \"Nth\" year of publication, but can be any\
- \ string.\nSee guide.\n"
- ext_ids:
- description: "Set of external identifiers for this release.\n"
- $ref: "#/definitions/release_ext_ids"
- withdrawn_year:
- type: "integer"
- format: "int64"
- example: 2014
- description: "Year corresponding with `withdrawn_date` like\n`release_year`/`release_date`.\n"
- withdrawn_date:
- type: "string"
- format: "date"
- description: "Full date when this release was formally withdrawn (if applicable).\n\
- ISO format, like `release_date`.\n"
- withdrawn_status:
- type: "string"
- example: "retracted"
- description: "Type of withdrawl or retraction of this release, if applicable.\
- \ If\nrelease has not been withdrawn, should be `null` (aka, not set, not\n\
- the string \"null\" or an empty string).\n"
- release_year:
- type: "integer"
- format: "int64"
- example: 2014
- description: "Year when this release was formally published. Must match\n\
- `release_date` if that field is set; this field exists because\nsometimes\
- \ only the year is known.\n"
- release_date:
- type: "string"
- format: "date"
- description: "Full date when this release was formally published. ISO format,\
- \ like\n`2019-03-05`. See guide for semantics.\n"
- release_stage:
- type: "string"
- example: "preprint"
- description: "The stage of publication of this specific release. See guide\
- \ for\nvalid values and semantics.\n"
- release_type:
- type: "string"
- example: "book"
- description: "\"Type\" or \"medium\" that this release is published as. See\
- \ guide for\nvalid values.\n"
- container_id:
- type: "string"
- example: "q3nouwy3nnbsvo3h5klxsx4a7y"
- description: "Used to link this release to a container entity that the release\
- \ was\npublished as part of.\n"
- webcaptures:
- type: "array"
- description: "Complete webcapture entities identified by `webcapture_ids`\
- \ field.\nOnly included in GET responses when `webcaptures` included in\
- \ `expand`\nparameter; ignored in PUT or POST requests.\n"
- items:
- $ref: "#/definitions/webcapture_entity"
- filesets:
- type: "array"
- description: "Complete file entities identified by `filesets_ids` field. Only\n\
- included in GET responses when `filesets` included in `expand`\nparameter;\
- \ ignored in PUT or POST requests.\n"
- items:
- $ref: "#/definitions/fileset_entity"
- files:
- type: "array"
- description: "Complete file entities identified by `file_ids` field. Only\n\
- included in GET responses when `files` included in `expand` parameter;\n\
- ignored in PUT or POST requests.\n"
- items:
- $ref: "#/definitions/file_entity"
- container:
- description: "Complete container entity identified by `container_id` field.\
- \ Only\nincluded in GET reponses when `container` included in `expand`\n\
- parameter; ignored in PUT or POST requests.\n"
- $ref: "#/definitions/container_entity"
- work_id:
- type: "string"
- example: "q3nouwy3nnbsvo3h5klxsx4a7y"
- description: "Identifier of work this release is part of. In creation (POST)\n\
- requests, a work entity will be created automatically if this field\nis\
- \ not set.\n"
- original_title:
- type: "string"
- description: "Title in original language if `title` field has been translated.\
- \ See\nguide for details.\n"
- subtitle:
- type: "string"
- description: "Subtitle of release. In many cases, better to merge with title\
- \ than\ninclude as separate field (unless combined title would be very long).\n\
- See guide for details.\n"
- title:
- type: "string"
- description: "Required for valid entities. The title used in citations and\
- \ for\ndisplay. Sometimes the English translation of title e even if release\n\
- content is not English.\n"
- state:
- type: "string"
- example: "active"
- enum:
- - "wip"
- - "active"
- - "redirect"
- - "deleted"
- ident:
- type: "string"
- example: "q3nouwy3nnbsvo3h5klxsx4a7y"
- description: "base32-encoded unique identifier"
- minLength: 26
- maxLength: 26
- pattern: "[a-zA-Z2-7]{26}"
- revision:
- type: "string"
- example: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- description: "UUID (lower-case, dash-separated, hex-encoded 128-bit)"
- minLength: 36
- maxLength: 36
- pattern: "[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}"
- redirect:
- type: "string"
- example: "q3nouwy3nnbsvo3h5klxsx4a7y"
- description: "base32-encoded unique identifier"
- minLength: 26
- maxLength: 26
- pattern: "[a-zA-Z2-7]{26}"
- extra:
- type: "object"
- description: "Free-form JSON metadata that will be stored with the other entity\n\
- metadata. See guide for (unenforced) schema conventions.\n"
- edit_extra:
- type: "object"
- description: "Free-form JSON metadata that will be stored with specific entity\
- \ edits\n(eg, creation/update/delete).\n"
- example:
- container:
- redirect: "q3nouwy3nnbsvo3h5klxsx4a7y"
- ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- extra: "{}"
- container_type: "journal"
- name: "Journal of Important Results"
- publisher: "Society of Curious Students"
- issnl: "1234-5678"
- wikidata_qid: "Q42812"
- state: "active"
- edit_extra: "{}"
- revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- webcaptures:
- - redirect: "q3nouwy3nnbsvo3h5klxsx4a7y"
- archive_urls:
- - rel: "wayback"
- url: "https://web.archive.org/web/"
- - rel: "wayback"
- url: "https://web.archive.org/web/"
- original_url: "http://asheesh.org"
- cdx:
- - sha1: "e9dd75237c94b209dc3ccd52722de6931a310ba3"
- surt: "org,asheesh)/apus/ch1/node15.html"
- status_code: 200
- size: 1048576
- sha256: "cb1c378f464d5935ddaa8de28446d82638396c61f042295d7fb85e3cccc9e452"
- mimetype: "text/html"
- url: "http://www.asheesh.org:80/APUS/ch1/node15.html"
- timestamp: "2016-09-19T17:20:24Z"
- - sha1: "e9dd75237c94b209dc3ccd52722de6931a310ba3"
- surt: "org,asheesh)/apus/ch1/node15.html"
- status_code: 200
- size: 1048576
- sha256: "cb1c378f464d5935ddaa8de28446d82638396c61f042295d7fb85e3cccc9e452"
- mimetype: "text/html"
- url: "http://www.asheesh.org:80/APUS/ch1/node15.html"
- timestamp: "2016-09-19T17:20:24Z"
- ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- extra: "{}"
- state: "active"
- release_ids:
- - "q3nouwy3nnbsvo3h5klxsx4a7y"
- - "q3nouwy3nnbsvo3h5klxsx4a7y"
- edit_extra: "{}"
- releases:
- - null
- - null
- timestamp: "2000-01-23T04:56:07.000+00:00"
- revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- - redirect: "q3nouwy3nnbsvo3h5klxsx4a7y"
- archive_urls:
- - rel: "wayback"
- url: "https://web.archive.org/web/"
- - rel: "wayback"
- url: "https://web.archive.org/web/"
- original_url: "http://asheesh.org"
- cdx:
- - sha1: "e9dd75237c94b209dc3ccd52722de6931a310ba3"
- surt: "org,asheesh)/apus/ch1/node15.html"
- status_code: 200
- size: 1048576
- sha256: "cb1c378f464d5935ddaa8de28446d82638396c61f042295d7fb85e3cccc9e452"
- mimetype: "text/html"
- url: "http://www.asheesh.org:80/APUS/ch1/node15.html"
- timestamp: "2016-09-19T17:20:24Z"
- - sha1: "e9dd75237c94b209dc3ccd52722de6931a310ba3"
- surt: "org,asheesh)/apus/ch1/node15.html"
- status_code: 200
- size: 1048576
- sha256: "cb1c378f464d5935ddaa8de28446d82638396c61f042295d7fb85e3cccc9e452"
- mimetype: "text/html"
- url: "http://www.asheesh.org:80/APUS/ch1/node15.html"
- timestamp: "2016-09-19T17:20:24Z"
- ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- extra: "{}"
- state: "active"
- release_ids:
- - "q3nouwy3nnbsvo3h5klxsx4a7y"
- - "q3nouwy3nnbsvo3h5klxsx4a7y"
- edit_extra: "{}"
- releases:
- - null
- - null
- timestamp: "2000-01-23T04:56:07.000+00:00"
- revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- withdrawn_status: "retracted"
- language: "en"
- title: "title"
- contribs:
- - raw_affiliation: "raw_affiliation"
- creator:
- redirect: "q3nouwy3nnbsvo3h5klxsx4a7y"
- surname: "surname"
- ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- extra: "{}"
- orcid: "0000-0002-1825-0097"
- wikidata_qid: "Q42812"
- state: "active"
- given_name: "given_name"
- display_name: "Grace Hopper"
- edit_extra: "{}"
- revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- raw_name: "Jane K. Doe"
- role: "author"
- surname: "Doe"
- extra: "{}"
- creator_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- index: 0
- given_name: "Jane"
- - raw_affiliation: "raw_affiliation"
- creator:
- redirect: "q3nouwy3nnbsvo3h5klxsx4a7y"
- surname: "surname"
- ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- extra: "{}"
- orcid: "0000-0002-1825-0097"
- wikidata_qid: "Q42812"
- state: "active"
- given_name: "given_name"
- display_name: "Grace Hopper"
- edit_extra: "{}"
- revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- raw_name: "Jane K. Doe"
- role: "author"
- surname: "Doe"
- extra: "{}"
- creator_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- index: 0
- given_name: "Jane"
- number: "RFC1337"
- pages: "340-345"
- extra: "{}"
- state: "active"
- edit_extra: "{}"
- withdrawn_year: 2014
- redirect: "q3nouwy3nnbsvo3h5klxsx4a7y"
- work_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- issue: "12"
- original_title: "original_title"
- abstracts:
- - sha1: "e9dd75237c94b209dc3ccd52722de6931a310ba3"
- mimetype: "application/xml+jats"
- lang: "en"
- content: "<jats:p>Some abstract thing goes here</jats:p>"
- - sha1: "e9dd75237c94b209dc3ccd52722de6931a310ba3"
- mimetype: "application/xml+jats"
- lang: "en"
- content: "<jats:p>Some abstract thing goes here</jats:p>"
- release_year: 2014
- release_type: "book"
- version: "3"
- revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- volume: "3"
- ext_ids:
- core: "core"
- mag: "mag"
- jstor: "jstor"
- isbn13: "isbn13"
- arxiv: "arxiv"
- wikidata_qid: "Q42812"
- ark: "ark"
- pmid: "482132"
- pmcid: "PMC7391"
- doi: "10.1234/abcde.789"
- release_stage: "preprint"
- license_slug: "CC-BY"
- withdrawn_date: "2000-01-23"
- refs:
- - target_release_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- container_name: "container_name"
- year: 1972
- extra: "{}"
- index: 0
- title: "title"
- locator: "p123"
- key: "SMITH2016"
- - target_release_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- container_name: "container_name"
- year: 1972
- extra: "{}"
- index: 0
- title: "title"
- locator: "p123"
- key: "SMITH2016"
- release_date: "2000-01-23"
- subtitle: "subtitle"
- publisher: "Elsevier"
- files:
- - redirect: "q3nouwy3nnbsvo3h5klxsx4a7y"
- sha256: "cb1c378f464d5935ddaa8de28446d82638396c61f042295d7fb85e3cccc9e452"
- ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- releases:
- - null
- - null
- revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- sha1: "e9dd75237c94b209dc3ccd52722de6931a310ba3"
- urls:
- - rel: "web"
- url: "https://example.edu/~frau/prcding.pdf"
- - rel: "web"
- url: "https://example.edu/~frau/prcding.pdf"
- size: 1048576
- extra: "{}"
- mimetype: "application/pdf"
- state: "active"
- release_ids:
- - "q3nouwy3nnbsvo3h5klxsx4a7y"
- - "q3nouwy3nnbsvo3h5klxsx4a7y"
- edit_extra: "{}"
- md5: "1b39813549077b2347c0f370c3864b40"
- - redirect: "q3nouwy3nnbsvo3h5klxsx4a7y"
- sha256: "cb1c378f464d5935ddaa8de28446d82638396c61f042295d7fb85e3cccc9e452"
- ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- releases:
- - null
- - null
- revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- sha1: "e9dd75237c94b209dc3ccd52722de6931a310ba3"
- urls:
- - rel: "web"
- url: "https://example.edu/~frau/prcding.pdf"
- - rel: "web"
- url: "https://example.edu/~frau/prcding.pdf"
- size: 1048576
- extra: "{}"
- mimetype: "application/pdf"
- state: "active"
- release_ids:
- - "q3nouwy3nnbsvo3h5klxsx4a7y"
- - "q3nouwy3nnbsvo3h5klxsx4a7y"
- edit_extra: "{}"
- md5: "1b39813549077b2347c0f370c3864b40"
- filesets:
- - redirect: "q3nouwy3nnbsvo3h5klxsx4a7y"
- urls:
- - rel: "webarchive"
- url: "https://example.edu/~frau/prcding.pdf"
- - rel: "webarchive"
- url: "https://example.edu/~frau/prcding.pdf"
- manifest:
- - sha1: "e9dd75237c94b209dc3ccd52722de6931a310ba3"
- path: "img/cat.png"
- size: 1048576
- sha256: "cb1c378f464d5935ddaa8de28446d82638396c61f042295d7fb85e3cccc9e452"
- extra: "{}"
- md5: "1b39813549077b2347c0f370c3864b40"
- - sha1: "e9dd75237c94b209dc3ccd52722de6931a310ba3"
- path: "img/cat.png"
- size: 1048576
- sha256: "cb1c378f464d5935ddaa8de28446d82638396c61f042295d7fb85e3cccc9e452"
- extra: "{}"
- md5: "1b39813549077b2347c0f370c3864b40"
- ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- extra: "{}"
- state: "active"
- release_ids:
- - "q3nouwy3nnbsvo3h5klxsx4a7y"
- - "q3nouwy3nnbsvo3h5klxsx4a7y"
- edit_extra: "{}"
- releases:
- - null
- - null
- revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- - redirect: "q3nouwy3nnbsvo3h5klxsx4a7y"
- urls:
- - rel: "webarchive"
- url: "https://example.edu/~frau/prcding.pdf"
- - rel: "webarchive"
- url: "https://example.edu/~frau/prcding.pdf"
- manifest:
- - sha1: "e9dd75237c94b209dc3ccd52722de6931a310ba3"
- path: "img/cat.png"
- size: 1048576
- sha256: "cb1c378f464d5935ddaa8de28446d82638396c61f042295d7fb85e3cccc9e452"
- extra: "{}"
- md5: "1b39813549077b2347c0f370c3864b40"
- - sha1: "e9dd75237c94b209dc3ccd52722de6931a310ba3"
- path: "img/cat.png"
- size: 1048576
- sha256: "cb1c378f464d5935ddaa8de28446d82638396c61f042295d7fb85e3cccc9e452"
- extra: "{}"
- md5: "1b39813549077b2347c0f370c3864b40"
- ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- extra: "{}"
- state: "active"
- release_ids:
- - "q3nouwy3nnbsvo3h5klxsx4a7y"
- - "q3nouwy3nnbsvo3h5klxsx4a7y"
- edit_extra: "{}"
- releases:
- - null
- - null
- revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- container_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- upperCaseName: "RELEASE_ENTITY"
- release_ext_ids:
- type: "object"
- properties:
- doi:
- type: "string"
- example: "10.1234/abcde.789"
- description: "Digital Object Identifier (DOI), mostly for published papers\
- \ and\ndatasets. Should be registered and resolvable via https://doi.org/\n"
- wikidata_qid:
- type: "string"
- example: "Q42812"
- description: "Wikidata entity QID"
- isbn13:
- type: "string"
- description: "ISBN-13, for books. Usually not set for chapters. ISBN-10 should\
- \ be\nconverted to ISBN-13.\n"
- pmid:
- type: "string"
- example: "482132"
- description: "PubMed Identifier"
- pmcid:
- type: "string"
- example: "PMC7391"
- description: "PubMed Central Identifier"
- core:
- type: "string"
- description: "CORE (https://core.ac.uk) identifier"
- arxiv:
- type: "string"
- description: "arXiv (https://arxiv.org) identifier; must include version"
- jstor:
- type: "string"
- description: "JSTOR work identifier"
- ark:
- type: "string"
- description: "ARK identifier"
- mag:
- type: "string"
- description: "Microsoft Academic Graph identifier"
- example:
- core: "core"
- mag: "mag"
- jstor: "jstor"
- isbn13: "isbn13"
- arxiv: "arxiv"
- wikidata_qid: "Q42812"
- ark: "ark"
- pmid: "482132"
- pmcid: "PMC7391"
- doi: "10.1234/abcde.789"
- upperCaseName: "RELEASE_EXT_IDS"
- release_abstract:
- type: "object"
- properties:
- sha1:
- type: "string"
- example: "e9dd75237c94b209dc3ccd52722de6931a310ba3"
- description: "SHA-1 hash of data, in hex encoding"
- minLength: 40
- maxLength: 40
- pattern: "[a-f0-9]{40}"
- content:
- type: "string"
- example: "<jats:p>Some abstract thing goes here</jats:p>"
- description: "Abstract content. May be encoded, as per `mimetype` field, but\
- \ only\nstring/text content may be included.\n"
- mimetype:
- type: "string"
- example: "application/xml+jats"
- description: "Mimetype of abstract contents. `text/plain` is the default if\
- \ content\nisn't encoded.\n"
- lang:
- type: "string"
- example: "en"
- description: "ISO language code of the abstract. Same semantics as release\
- \ `language` field.\n"
- example:
- sha1: "e9dd75237c94b209dc3ccd52722de6931a310ba3"
- mimetype: "application/xml+jats"
- lang: "en"
- content: "<jats:p>Some abstract thing goes here</jats:p>"
- upperCaseName: "RELEASE_ABSTRACT"
- work_entity:
- type: "object"
- properties:
- edit_extra:
- type: "object"
- description: "Free-form JSON metadata that will be stored with specific entity\
- \ edits\n(eg, creation/update/delete).\n"
- extra:
- type: "object"
- description: "Free-form JSON metadata that will be stored with the other entity\n\
- metadata. See guide for (unenforced) schema conventions.\n"
- redirect:
- type: "string"
- example: "q3nouwy3nnbsvo3h5klxsx4a7y"
- description: "base32-encoded unique identifier"
- minLength: 26
- maxLength: 26
- pattern: "[a-zA-Z2-7]{26}"
- revision:
- type: "string"
- example: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- description: "UUID (lower-case, dash-separated, hex-encoded 128-bit)"
- minLength: 36
- maxLength: 36
- pattern: "[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}"
- ident:
- type: "string"
- example: "q3nouwy3nnbsvo3h5klxsx4a7y"
- description: "base32-encoded unique identifier"
- minLength: 26
- maxLength: 26
- pattern: "[a-zA-Z2-7]{26}"
- state:
- type: "string"
- example: "active"
- enum:
- - "wip"
- - "active"
- - "redirect"
- - "deleted"
- example:
- redirect: "q3nouwy3nnbsvo3h5klxsx4a7y"
- ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- extra: "{}"
- state: "active"
- edit_extra: "{}"
- revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- upperCaseName: "WORK_ENTITY"
- entity_history_entry:
- type: "object"
- required:
- - "changelog_entry"
- - "edit"
- - "editgroup"
- properties:
- edit:
- $ref: "#/definitions/entity_edit"
- editgroup:
- $ref: "#/definitions/editgroup"
- changelog_entry:
- $ref: "#/definitions/changelog_entry"
- example:
- editgroup:
- editor:
- is_admin: false
- is_active: true
- editor_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- is_bot: false
- username: "zerocool93"
- changelog_index: 1048576
- submitted: "2000-01-23T04:56:07.000+00:00"
- created: "2000-01-23T04:56:07.000+00:00"
- extra: "{}"
- edits:
- works:
- - ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- edit_id: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- extra: "{}"
- redirect_ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- editgroup_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- prev_revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- - ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- edit_id: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- extra: "{}"
- redirect_ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- editgroup_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- prev_revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- webcaptures:
- - ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- edit_id: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- extra: "{}"
- redirect_ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- editgroup_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- prev_revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- - ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- edit_id: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- extra: "{}"
- redirect_ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- editgroup_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- prev_revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- creators:
- - ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- edit_id: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- extra: "{}"
- redirect_ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- editgroup_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- prev_revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- - ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- edit_id: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- extra: "{}"
- redirect_ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- editgroup_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- prev_revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- files:
- - ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- edit_id: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- extra: "{}"
- redirect_ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- editgroup_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- prev_revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- - ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- edit_id: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- extra: "{}"
- redirect_ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- editgroup_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- prev_revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- containers:
- - ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- edit_id: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- extra: "{}"
- redirect_ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- editgroup_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- prev_revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- - ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- edit_id: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- extra: "{}"
- redirect_ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- editgroup_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- prev_revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- filesets:
- - ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- edit_id: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- extra: "{}"
- redirect_ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- editgroup_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- prev_revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- - ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- edit_id: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- extra: "{}"
- redirect_ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- editgroup_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- prev_revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- releases:
- - ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- edit_id: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- extra: "{}"
- redirect_ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- editgroup_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- prev_revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- - ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- edit_id: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- extra: "{}"
- redirect_ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- editgroup_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- prev_revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- editgroup_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- description: "description"
- annotations:
- - annotation_id: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- editor:
- is_admin: false
- is_active: true
- editor_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- is_bot: false
- username: "zerocool93"
- created: "2000-01-23T04:56:07.000+00:00"
- extra: "{}"
- editgroup_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- editor_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- comment_markdown: "comment_markdown"
- - annotation_id: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- editor:
- is_admin: false
- is_active: true
- editor_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- is_bot: false
- username: "zerocool93"
- created: "2000-01-23T04:56:07.000+00:00"
- extra: "{}"
- editgroup_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- editor_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- comment_markdown: "comment_markdown"
- editor_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- edit:
- ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- edit_id: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- extra: "{}"
- redirect_ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- editgroup_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- prev_revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- changelog_entry:
- editgroup:
- editor:
- is_admin: false
- is_active: true
- editor_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- is_bot: false
- username: "zerocool93"
- changelog_index: 1048576
- submitted: "2000-01-23T04:56:07.000+00:00"
- created: "2000-01-23T04:56:07.000+00:00"
- extra: "{}"
- edits:
- works:
- - ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- edit_id: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- extra: "{}"
- redirect_ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- editgroup_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- prev_revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- - ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- edit_id: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- extra: "{}"
- redirect_ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- editgroup_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- prev_revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- webcaptures:
- - ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- edit_id: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- extra: "{}"
- redirect_ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- editgroup_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- prev_revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- - ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- edit_id: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- extra: "{}"
- redirect_ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- editgroup_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- prev_revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- creators:
- - ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- edit_id: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- extra: "{}"
- redirect_ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- editgroup_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- prev_revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- - ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- edit_id: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- extra: "{}"
- redirect_ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- editgroup_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- prev_revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- files:
- - ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- edit_id: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- extra: "{}"
- redirect_ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- editgroup_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- prev_revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- - ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- edit_id: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- extra: "{}"
- redirect_ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- editgroup_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- prev_revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- containers:
- - ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- edit_id: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- extra: "{}"
- redirect_ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- editgroup_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- prev_revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- - ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- edit_id: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- extra: "{}"
- redirect_ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- editgroup_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- prev_revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- filesets:
- - ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- edit_id: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- extra: "{}"
- redirect_ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- editgroup_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- prev_revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- - ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- edit_id: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- extra: "{}"
- redirect_ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- editgroup_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- prev_revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- releases:
- - ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- edit_id: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- extra: "{}"
- redirect_ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- editgroup_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- prev_revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- - ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- edit_id: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- extra: "{}"
- redirect_ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- editgroup_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- prev_revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- editgroup_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- description: "description"
- annotations:
- - annotation_id: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- editor:
- is_admin: false
- is_active: true
- editor_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- is_bot: false
- username: "zerocool93"
- created: "2000-01-23T04:56:07.000+00:00"
- extra: "{}"
- editgroup_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- editor_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- comment_markdown: "comment_markdown"
- - annotation_id: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- editor:
- is_admin: false
- is_active: true
- editor_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- is_bot: false
- username: "zerocool93"
- created: "2000-01-23T04:56:07.000+00:00"
- extra: "{}"
- editgroup_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- editor_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- comment_markdown: "comment_markdown"
- editor_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- index: 0
- editgroup_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- timestamp: "2000-01-23T04:56:07.000+00:00"
- upperCaseName: "ENTITY_HISTORY_ENTRY"
- entity_edit:
- type: "object"
- required:
- - "edit_id"
- - "editgroup_id"
- - "ident"
- properties:
- edit_id:
- type: "string"
- example: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- description: "Unique UUID for this specific edit object.\n"
- minLength: 36
- maxLength: 36
- pattern: "[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}"
- ident:
- type: "string"
- example: "q3nouwy3nnbsvo3h5klxsx4a7y"
- description: "Fatcat identifier of the entity this edit is mutating.\n"
- minLength: 26
- maxLength: 26
- pattern: "[a-zA-Z2-7]{26}"
- revision:
- type: "string"
- example: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- description: "Entity revision that this edit will set the entity to. May be\n\
- `null` in the case of deletions.\n"
- minLength: 36
- maxLength: 36
- pattern: "[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}"
- prev_revision:
- type: "string"
- example: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- description: "Revision of entity just before this edit. May be used in the\
- \ future\nto prevent edit race conditions.\n"
- minLength: 36
- maxLength: 36
- pattern: "[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}"
- redirect_ident:
- type: "string"
- example: "q3nouwy3nnbsvo3h5klxsx4a7y"
- description: "When an edit is to merge entities (redirect one to another),\
- \ this\nis the entity fatcat identifier for the target entity.\n"
- minLength: 26
- maxLength: 26
- pattern: "[a-zA-Z2-7]{26}"
- editgroup_id:
- type: "string"
- example: "q3nouwy3nnbsvo3h5klxsx4a7y"
- description: "Editgroup identifier that this edit is part of.\n"
- minLength: 26
- maxLength: 26
- pattern: "[a-zA-Z2-7]{26}"
- extra:
- type: "object"
- example:
- ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- edit_id: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- extra: "{}"
- redirect_ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- editgroup_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- prev_revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- upperCaseName: "ENTITY_EDIT"
- editor:
- type: "object"
- required:
- - "username"
- properties:
- editor_id:
- type: "string"
- example: "q3nouwy3nnbsvo3h5klxsx4a7y"
- description: "Fatcat identifier for the editor. Can not be changed.\n"
- minLength: 26
- maxLength: 26
- pattern: "[a-zA-Z2-7]{26}"
- username:
- type: "string"
- example: "zerocool93"
- description: "Username/handle (short slug-like string) to identify this editor.\
- \ May\nbe changed at any time by the editor; use the `editor_id` as a\n\
- persistend identifer.\n"
- is_admin:
- type: "boolean"
- example: false
- description: "Whether this editor has the `admin` role.\n"
- is_bot:
- type: "boolean"
- example: false
- description: "Whether this editor is a bot (as opposed to a human making manual\n\
- edits)\n"
- is_active:
- type: "boolean"
- example: true
- description: "Whether this editor's account is enabled (if not API tokens\
- \ and web\nlogins will not work).\n"
- example:
- is_admin: false
- is_active: true
- editor_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- is_bot: false
- username: "zerocool93"
- upperCaseName: "EDITOR"
- editgroup:
- type: "object"
- properties:
- editgroup_id:
- type: "string"
- example: "q3nouwy3nnbsvo3h5klxsx4a7y"
- description: "Fatcat identifier for this editgroup. Assigned on creation.\n"
- minLength: 26
- maxLength: 26
- pattern: "[a-zA-Z2-7]{26}"
- editor_id:
- type: "string"
- example: "q3nouwy3nnbsvo3h5klxsx4a7y"
- description: "Fatcat identifer of editor that created this editgroup.\n"
- minLength: 26
- maxLength: 26
- pattern: "[a-zA-Z2-7]{26}"
- editor:
- description: "Complete editor object identified by `container_id` field. Only\n\
- included in GET responses.\n"
- $ref: "#/definitions/editor"
- changelog_index:
- type: "integer"
- format: "int64"
- example: 1048576
- description: "For accepted/merged editgroups, the changelog index that the\
- \ accept\noccured at. WARNING: not populated in all contexts that an editgroup\n\
- could be included in a response.\n"
- created:
- type: "string"
- format: "date-time"
- description: "Timestamp when this editgroup was first created.\n"
- submitted:
- type: "string"
- format: "date-time"
- description: "Timestamp when this editgroup was most recently submitted for\
- \ review.\nIf withdrawn, or never submitted, will be `null`.\n"
- description:
- type: "string"
- description: "Comment describing the changes in this editgroup. Can be updated\
- \ with\nPUT request.\n"
- extra:
- type: "object"
- description: "Free-form JSON metadata attached to this editgroup. Eg, metadata\n\
- provenance, or script user-agent details. See guide for (unenforced)\nschema\
- \ norms.\n"
- annotations:
- type: "array"
- description: "Only included in GET responses, and not in all contexts. Do\
- \ not\ninclude this field in PUT or POST requests.\n"
- items:
- $ref: "#/definitions/editgroup_annotation"
- edits:
- $ref: "#/definitions/editgroup_edits"
- example:
- editor:
- is_admin: false
- is_active: true
- editor_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- is_bot: false
- username: "zerocool93"
- changelog_index: 1048576
- submitted: "2000-01-23T04:56:07.000+00:00"
- created: "2000-01-23T04:56:07.000+00:00"
- extra: "{}"
- edits:
- works:
- - ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- edit_id: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- extra: "{}"
- redirect_ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- editgroup_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- prev_revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- - ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- edit_id: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- extra: "{}"
- redirect_ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- editgroup_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- prev_revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- webcaptures:
- - ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- edit_id: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- extra: "{}"
- redirect_ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- editgroup_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- prev_revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- - ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- edit_id: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- extra: "{}"
- redirect_ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- editgroup_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- prev_revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- creators:
- - ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- edit_id: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- extra: "{}"
- redirect_ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- editgroup_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- prev_revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- - ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- edit_id: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- extra: "{}"
- redirect_ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- editgroup_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- prev_revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- files:
- - ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- edit_id: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- extra: "{}"
- redirect_ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- editgroup_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- prev_revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- - ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- edit_id: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- extra: "{}"
- redirect_ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- editgroup_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- prev_revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- containers:
- - ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- edit_id: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- extra: "{}"
- redirect_ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- editgroup_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- prev_revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- - ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- edit_id: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- extra: "{}"
- redirect_ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- editgroup_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- prev_revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- filesets:
- - ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- edit_id: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- extra: "{}"
- redirect_ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- editgroup_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- prev_revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- - ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- edit_id: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- extra: "{}"
- redirect_ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- editgroup_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- prev_revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- releases:
- - ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- edit_id: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- extra: "{}"
- redirect_ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- editgroup_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- prev_revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- - ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- edit_id: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- extra: "{}"
- redirect_ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- editgroup_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- prev_revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- editgroup_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- description: "description"
- annotations:
- - annotation_id: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- editor:
- is_admin: false
- is_active: true
- editor_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- is_bot: false
- username: "zerocool93"
- created: "2000-01-23T04:56:07.000+00:00"
- extra: "{}"
- editgroup_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- editor_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- comment_markdown: "comment_markdown"
- - annotation_id: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- editor:
- is_admin: false
- is_active: true
- editor_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- is_bot: false
- username: "zerocool93"
- created: "2000-01-23T04:56:07.000+00:00"
- extra: "{}"
- editgroup_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- editor_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- comment_markdown: "comment_markdown"
- editor_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- upperCaseName: "EDITGROUP"
- editgroup_annotation:
- type: "object"
- properties:
- annotation_id:
- type: "string"
- example: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- description: "UUID (lower-case, dash-separated, hex-encoded 128-bit)"
- minLength: 36
- maxLength: 36
- pattern: "[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}"
- editgroup_id:
- type: "string"
- example: "q3nouwy3nnbsvo3h5klxsx4a7y"
- description: "Editgroup that this annotation applies to. Set automatically\
- \ in\ncreations based on URL parameter.\n"
- minLength: 26
- maxLength: 26
- pattern: "[a-zA-Z2-7]{26}"
- editor_id:
- type: "string"
- example: "q3nouwy3nnbsvo3h5klxsx4a7y"
- description: "Defaults to editor created the annotation via POST request.\n"
- minLength: 26
- maxLength: 26
- pattern: "[a-zA-Z2-7]{26}"
- editor:
- description: "Only included in GET responses; ignored in PUT or POST requests.\n"
- $ref: "#/definitions/editor"
- created:
- type: "string"
- format: "date-time"
- description: "Timestamp when annotation was first created.\n"
- comment_markdown:
- type: "string"
- extra:
- type: "object"
- description: "Additional free-form JSON metadata that can be included as part\
- \ of\nthe annotation (or even as the primary annotation itself). See guide\n\
- for details.\n"
- example:
- annotation_id: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- editor:
- is_admin: false
- is_active: true
- editor_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- is_bot: false
- username: "zerocool93"
- created: "2000-01-23T04:56:07.000+00:00"
- extra: "{}"
- editgroup_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- editor_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- comment_markdown: "comment_markdown"
- upperCaseName: "EDITGROUP_ANNOTATION"
- changelog_entry:
- type: "object"
- required:
- - "editgroup_id"
- - "index"
- - "timestamp"
- properties:
- index:
- type: "integer"
- format: "int64"
- description: "Monotonically increasing sequence number of this changelog entry.\n"
- editgroup_id:
- type: "string"
- example: "q3nouwy3nnbsvo3h5klxsx4a7y"
- description: "Identifier of editgroup accepted/merged in this changelog entry.\n"
- timestamp:
- type: "string"
- format: "date-time"
- description: "Date and time when the editgroup was accpeted.\n"
- editgroup:
- $ref: "#/definitions/editgroup"
- example:
- editgroup:
- editor:
- is_admin: false
- is_active: true
- editor_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- is_bot: false
- username: "zerocool93"
- changelog_index: 1048576
- submitted: "2000-01-23T04:56:07.000+00:00"
- created: "2000-01-23T04:56:07.000+00:00"
- extra: "{}"
- edits:
- works:
- - ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- edit_id: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- extra: "{}"
- redirect_ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- editgroup_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- prev_revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- - ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- edit_id: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- extra: "{}"
- redirect_ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- editgroup_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- prev_revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- webcaptures:
- - ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- edit_id: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- extra: "{}"
- redirect_ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- editgroup_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- prev_revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- - ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- edit_id: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- extra: "{}"
- redirect_ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- editgroup_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- prev_revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- creators:
- - ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- edit_id: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- extra: "{}"
- redirect_ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- editgroup_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- prev_revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- - ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- edit_id: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- extra: "{}"
- redirect_ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- editgroup_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- prev_revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- files:
- - ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- edit_id: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- extra: "{}"
- redirect_ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- editgroup_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- prev_revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- - ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- edit_id: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- extra: "{}"
- redirect_ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- editgroup_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- prev_revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- containers:
- - ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- edit_id: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- extra: "{}"
- redirect_ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- editgroup_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- prev_revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- - ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- edit_id: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- extra: "{}"
- redirect_ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- editgroup_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- prev_revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- filesets:
- - ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- edit_id: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- extra: "{}"
- redirect_ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- editgroup_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- prev_revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- - ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- edit_id: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- extra: "{}"
- redirect_ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- editgroup_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- prev_revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- releases:
- - ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- edit_id: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- extra: "{}"
- redirect_ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- editgroup_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- prev_revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- - ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- edit_id: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- extra: "{}"
- redirect_ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- editgroup_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- prev_revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- editgroup_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- description: "description"
- annotations:
- - annotation_id: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- editor:
- is_admin: false
- is_active: true
- editor_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- is_bot: false
- username: "zerocool93"
- created: "2000-01-23T04:56:07.000+00:00"
- extra: "{}"
- editgroup_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- editor_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- comment_markdown: "comment_markdown"
- - annotation_id: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- editor:
- is_admin: false
- is_active: true
- editor_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- is_bot: false
- username: "zerocool93"
- created: "2000-01-23T04:56:07.000+00:00"
- extra: "{}"
- editgroup_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- editor_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- comment_markdown: "comment_markdown"
- editor_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- index: 0
- editgroup_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- timestamp: "2000-01-23T04:56:07.000+00:00"
- upperCaseName: "CHANGELOG_ENTRY"
- release_ref:
- type: "object"
- properties:
- index:
- type: "integer"
- format: "int64"
- description: "Zero-indexed sequence number of this reference in the list of\n\
- references. Assigned automatically and used internally; don't confuse\n\
- with `key`.\n"
- target_release_id:
- type: "string"
- example: "q3nouwy3nnbsvo3h5klxsx4a7y"
- description: "Optional, fatcat identifier of release entity that this reference\
- \ is\nciting.\n"
- minLength: 26
- maxLength: 26
- pattern: "[a-zA-Z2-7]{26}"
- extra:
- type: "object"
- description: "Additional free-form JSON metadata about this citation. Generally\n\
- follows Citation Style Language (CSL) JSON schema. See guide for\ndetails.\n"
- key:
- type: "string"
- example: "SMITH2016"
- description: "Short string used to indicate this reference from within the\
- \ release\ntext; or numbering of references as typeset in the release itself.\n\
- Optional; don't confuse with `index` field.\n"
- year:
- type: "integer"
- format: "int64"
- example: 1972
- description: "Year that the cited work was published in.\n"
- container_name:
- type: "string"
- description: "Name of the container (eg, journal) that the citation work was\n\
- published as part of. May be an acronym or full name.\n"
- title:
- type: "string"
- description: "Name of the work being cited."
- locator:
- type: "string"
- example: "p123"
- description: "Page number or other indicator of the specific subset of a work\
- \ being\ncited. Not to be confused with the first page (or page range) of\
- \ an\nentire paper or chapter being cited.\n"
- example:
- target_release_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- container_name: "container_name"
- year: 1972
- extra: "{}"
- index: 0
- title: "title"
- locator: "p123"
- key: "SMITH2016"
- upperCaseName: "RELEASE_REF"
- release_contrib:
- type: "object"
- properties:
- index:
- type: "integer"
- format: "int64"
- example: 0
- description: "Internally assigned zero-indexed sequence number of contribution.\n\
- Authors should come first; this encodes the order of attriubtion.\n"
- creator_id:
- type: "string"
- example: "q3nouwy3nnbsvo3h5klxsx4a7y"
- description: "If known, indicates the creator entity this contribution was\
- \ made by.\n"
- minLength: 26
- maxLength: 26
- pattern: "[a-zA-Z2-7]{26}"
- creator:
- description: "Complete creator entity. Only returned in GET responses, and\
- \ only if\n`contribs` included in the `expand` query parameter.\n"
- $ref: "#/definitions/creator_entity"
- raw_name:
- type: "string"
- example: "Jane K. Doe"
- description: "Full name of the contributor as typeset in the release.\n"
- given_name:
- type: "string"
- example: "Jane"
- description: "In English commonly the first name, but ordering is context\
- \ and\nculture specific.\n"
- surname:
- type: "string"
- example: "Doe"
- description: "In English commonly the last, or family name, but ordering is\
- \ context\nand culture specific.\n"
- role:
- type: "string"
- example: "author"
- description: "Short string (slug) indicating type of contribution (eg, \"\
- author\",\n\"translator\"). See guide for list of accpeted values.\n"
- raw_affiliation:
- type: "string"
- description: "Raw affiliation string as displayed in text"
- extra:
- type: "object"
- description: "Additional free-form JSON metadata about this\ncontributor/contribution.\
- \ See guide for normative schema.\n"
- example:
- raw_affiliation: "raw_affiliation"
- creator:
- redirect: "q3nouwy3nnbsvo3h5klxsx4a7y"
- surname: "surname"
- ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- extra: "{}"
- orcid: "0000-0002-1825-0097"
- wikidata_qid: "Q42812"
- state: "active"
- given_name: "given_name"
- display_name: "Grace Hopper"
- edit_extra: "{}"
- revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- raw_name: "Jane K. Doe"
- role: "author"
- surname: "Doe"
- extra: "{}"
- creator_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- index: 0
- given_name: "Jane"
- upperCaseName: "RELEASE_CONTRIB"
- container_auto_batch:
- type: "object"
- required:
- - "editgroup"
- - "entity_list"
- properties:
- editgroup:
- $ref: "#/definitions/editgroup"
- entity_list:
- type: "array"
- items:
- $ref: "#/definitions/container_entity"
- upperCaseName: "CONTAINER_AUTO_BATCH"
- creator_auto_batch:
- type: "object"
- required:
- - "editgroup"
- - "entity_list"
- properties:
- editgroup:
- $ref: "#/definitions/editgroup"
- entity_list:
- type: "array"
- items:
- $ref: "#/definitions/creator_entity"
- upperCaseName: "CREATOR_AUTO_BATCH"
- file_auto_batch:
- type: "object"
- required:
- - "editgroup"
- - "entity_list"
- properties:
- editgroup:
- $ref: "#/definitions/editgroup"
- entity_list:
- type: "array"
- items:
- $ref: "#/definitions/file_entity"
- upperCaseName: "FILE_AUTO_BATCH"
- fileset_auto_batch:
- type: "object"
- required:
- - "editgroup"
- - "entity_list"
- properties:
- editgroup:
- $ref: "#/definitions/editgroup"
- entity_list:
- type: "array"
- items:
- $ref: "#/definitions/fileset_entity"
- upperCaseName: "FILESET_AUTO_BATCH"
- webcapture_auto_batch:
- type: "object"
- required:
- - "editgroup"
- - "entity_list"
- properties:
- editgroup:
- $ref: "#/definitions/editgroup"
- entity_list:
- type: "array"
- items:
- $ref: "#/definitions/webcapture_entity"
- upperCaseName: "WEBCAPTURE_AUTO_BATCH"
- release_auto_batch:
- type: "object"
- required:
- - "editgroup"
- - "entity_list"
- properties:
- editgroup:
- $ref: "#/definitions/editgroup"
- entity_list:
- type: "array"
- items:
- $ref: "#/definitions/release_entity"
- upperCaseName: "RELEASE_AUTO_BATCH"
- work_auto_batch:
- type: "object"
- required:
- - "editgroup"
- - "entity_list"
- properties:
- editgroup:
- $ref: "#/definitions/editgroup"
- entity_list:
- type: "array"
- items:
- $ref: "#/definitions/work_entity"
- upperCaseName: "WORK_AUTO_BATCH"
- auth_oidc:
- type: "object"
- required:
- - "iss"
- - "preferred_username"
- - "provider"
- - "sub"
- properties:
- provider:
- type: "string"
- example: "orcid"
- description: "Fatcat-specific short name (slug) for remote service being used\
- \ for\nauthentication.\n"
- sub:
- type: "string"
- example: "https://orcid.org"
- description: "`SUB` from OIDC protocol. Usually a URL."
- iss:
- type: "string"
- example: "0000-0002-8593-9468"
- description: "`ISS` from OIDC protocol. Usually a stable account username,\
- \ number, or identifier."
- preferred_username:
- type: "string"
- example: "bnewbold"
- description: "What it sounds like; returned by OIDC, and used as a hint when\n\
- creating new editor accounts. Fatcat usernames are usually this\nstring\
- \ with the `provider` slug as a suffix, though some munging may\noccur.\n"
- upperCaseName: "AUTH_OIDC"
- auth_oidc_result:
- type: "object"
- required:
- - "editor"
- - "token"
- properties:
- editor:
- $ref: "#/definitions/editor"
- token:
- type: "string"
- example: "AgEPZGV2LmZhdGNhdC53aWtpAhYyMDE5MDEwMS1kZXYtZHVtbXkta2V5AAImZWRpdG9yX2lkID0gYWFhYWFhYWFhYWFhYmt2a2FhYWFhYWFhYWkAAht0aW1lID4gMjAxOS0wMS0wOVQwMDo1Nzo1MloAAAYgnroNha1hSftChtxHGTnLEmM/pY8MeQS/jBSV0UNvXug="
- example:
- editor:
- is_admin: false
- is_active: true
- editor_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- is_bot: false
- username: "zerocool93"
- token: "AgEPZGV2LmZhdGNhdC53aWtpAhYyMDE5MDEwMS1kZXYtZHVtbXkta2V5AAImZWRpdG9yX2lkID0gYWFhYWFhYWFhYWFhYmt2a2FhYWFhYWFhYWkAAht0aW1lID4gMjAxOS0wMS0wOVQwMDo1Nzo1MloAAAYgnroNha1hSftChtxHGTnLEmM/pY8MeQS/jBSV0UNvXug="
- upperCaseName: "AUTH_OIDC_RESULT"
- auth_token_result:
- type: "object"
- required:
- - "token"
- properties:
- token:
- type: "string"
- example: "AgEPZGV2LmZhdGNhdC53aWtpAhYyMDE5MDEwMS1kZXYtZHVtbXkta2V5AAImZWRpdG9yX2lkID0gYWFhYWFhYWFhYWFhYmt2a2FhYWFhYWFhYWkAAht0aW1lID4gMjAxOS0wMS0wOVQwMDo1Nzo1MloAAAYgnroNha1hSftChtxHGTnLEmM/pY8MeQS/jBSV0UNvXug="
- example:
- token: "AgEPZGV2LmZhdGNhdC53aWtpAhYyMDE5MDEwMS1kZXYtZHVtbXkta2V5AAImZWRpdG9yX2lkID0gYWFhYWFhYWFhYWFhYmt2a2FhYWFhYWFhYWkAAht0aW1lID4gMjAxOS0wMS0wOVQwMDo1Nzo1MloAAAYgnroNha1hSftChtxHGTnLEmM/pY8MeQS/jBSV0UNvXug="
- upperCaseName: "AUTH_TOKEN_RESULT"
- editgroup_edits:
- properties:
- containers:
- type: "array"
- items:
- $ref: "#/definitions/entity_edit"
- creators:
- type: "array"
- items:
- $ref: "#/definitions/entity_edit"
- files:
- type: "array"
- items:
- $ref: "#/definitions/entity_edit"
- filesets:
- type: "array"
- items:
- $ref: "#/definitions/entity_edit"
- webcaptures:
- type: "array"
- items:
- $ref: "#/definitions/entity_edit"
- releases:
- type: "array"
- items:
- $ref: "#/definitions/entity_edit"
- works:
- type: "array"
- items:
- $ref: "#/definitions/entity_edit"
- description: "Only included in GET responses, and not in all contexts. Do not\n\
- include this field in PUT or POST requests.\n"
- example:
- works:
- - ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- edit_id: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- extra: "{}"
- redirect_ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- editgroup_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- prev_revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- - ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- edit_id: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- extra: "{}"
- redirect_ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- editgroup_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- prev_revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- webcaptures:
- - ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- edit_id: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- extra: "{}"
- redirect_ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- editgroup_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- prev_revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- - ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- edit_id: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- extra: "{}"
- redirect_ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- editgroup_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- prev_revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- creators:
- - ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- edit_id: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- extra: "{}"
- redirect_ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- editgroup_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- prev_revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- - ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- edit_id: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- extra: "{}"
- redirect_ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- editgroup_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- prev_revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- files:
- - ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- edit_id: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- extra: "{}"
- redirect_ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- editgroup_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- prev_revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- - ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- edit_id: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- extra: "{}"
- redirect_ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- editgroup_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- prev_revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- containers:
- - ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- edit_id: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- extra: "{}"
- redirect_ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- editgroup_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- prev_revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- - ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- edit_id: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- extra: "{}"
- redirect_ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- editgroup_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- prev_revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- filesets:
- - ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- edit_id: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- extra: "{}"
- redirect_ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- editgroup_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- prev_revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- - ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- edit_id: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- extra: "{}"
- redirect_ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- editgroup_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- prev_revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- releases:
- - ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- edit_id: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- extra: "{}"
- redirect_ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- editgroup_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- prev_revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- - ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- edit_id: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- extra: "{}"
- redirect_ident: "q3nouwy3nnbsvo3h5klxsx4a7y"
- editgroup_id: "q3nouwy3nnbsvo3h5klxsx4a7y"
- prev_revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- revision: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- upperCaseName: "EDITGROUP_EDITS"
-x-servers:
-- url: "https://api.fatcat.wiki/v0"
- description: "Production Server"
-- url: "https://api.qa.fatcat.wiki/v0"
- description: "QA Server"
-x-tagGroups:
-- name: "Entities"
- tags:
- - "containers"
- - "creators"
- - "files"
- - "filesets"
- - "webcaptures"
- - "releases"
- - "works"
-- name: "Editing"
- tags:
- - "editors"
- - "editgroups"
- - "changelog"
-- name: "Other"
- tags:
- - "auth"
-x-fatcat-ident:
- type: "string"
- pattern: "[a-zA-Z2-7]{26}"
- minLength: 26
- maxLength: 26
- description: "base32-encoded unique identifier"
-x-fatcat-ident-example:
- example: "q3nouwy3nnbsvo3h5klxsx4a7y"
-x-fatcat-uuid:
- type: "string"
- pattern: "[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}"
- minLength: 36
- maxLength: 36
- description: "UUID (lower-case, dash-separated, hex-encoded 128-bit)"
-x-fatcat-uuid-example:
- example: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
-x-issn:
- type: "string"
- pattern: "\\d{4}-\\d{3}[0-9X]"
- minLength: 9
- maxLength: 9
-x-issn-example:
- example: "1234-5678"
-x-orcid:
- type: "string"
- pattern: "\\d{4}-\\d{4}-\\d{4}-\\d{3}[\\dX]"
- minLength: 19
- maxLength: 19
- description: "ORCiD (https://orcid.org) identifier"
-x-orcid-example:
- example: "0000-0002-1825-0097"
-x-md5:
- type: "string"
- pattern: "[a-f0-9]{32}"
- minLength: 32
- maxLength: 32
- description: "MD5 hash of data, in hex encoding"
-x-md5-example:
- example: "1b39813549077b2347c0f370c3864b40"
-x-sha1:
- type: "string"
- pattern: "[a-f0-9]{40}"
- minLength: 40
- maxLength: 40
- description: "SHA-1 hash of data, in hex encoding"
-x-sha1-example:
- example: "e9dd75237c94b209dc3ccd52722de6931a310ba3"
-x-sha256:
- type: "string"
- pattern: "[a-f0-9]{64}"
- minLength: 64
- maxLength: 64
- description: "SHA-256 hash of data, in hex encoding"
-x-sha256-example:
- example: "cb1c378f464d5935ddaa8de28446d82638396c61f042295d7fb85e3cccc9e452"
-x-entity-props:
- state:
- type: "string"
- enum:
- - "wip"
- - "active"
- - "redirect"
- - "deleted"
- example: "active"
- ident:
- example: "q3nouwy3nnbsvo3h5klxsx4a7y"
- description: "base32-encoded unique identifier"
- maxLength: 26
- minLength: 26
- pattern: "[a-zA-Z2-7]{26}"
- type: "string"
- revision:
- example: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
- description: "UUID (lower-case, dash-separated, hex-encoded 128-bit)"
- maxLength: 36
- minLength: 36
- pattern: "[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}"
- type: "string"
- redirect:
- example: "q3nouwy3nnbsvo3h5klxsx4a7y"
- type: "string"
- pattern: "[a-zA-Z2-7]{26}"
- minLength: 26
- maxLength: 26
- description: "base32-encoded unique identifier"
- extra:
- type: "object"
- description: "Free-form JSON metadata that will be stored with the other entity\n\
- metadata. See guide for (unenforced) schema conventions.\n"
- additionalProperties: {}
- edit_extra:
- type: "object"
- description: "Free-form JSON metadata that will be stored with specific entity\
- \ edits\n(eg, creation/update/delete).\n"
- additionalProperties: {}
-x-auth-responses:
- 401:
- description: "Not Authorized"
- schema:
- $ref: "#/definitions/error_response"
- headers:
- WWW_Authenticate:
- type: "string"
- 403:
- description: "Forbidden"
- schema:
- $ref: "#/definitions/error_response"
-x-entity-responses:
- 400:
- description: "Bad Request"
- schema:
- $ref: "#/definitions/error_response"
- 404:
- description: "Not Found"
- schema:
- $ref: "#/definitions/error_response"
- 500:
- description: "Generic Error"
- schema:
- $ref: "#/definitions/error_response"