openapi: 3.2.0 info: description: 'This Swagger Page is for the FOIA Request Portal. Information about the FOIA Agency API can be found on the API Specs page. Authorization with API Key Use the Authorize button below to enter your api_key if you have one. You can signup for an API key or use the following api_key for testing. N4aCuDuJO8Ucf1FTR2EzVPZqo8NsSl1c7YLYOk8N Agency Component Entity ID You can use the Entity ID for Office of Information Policy in the examples below: 8216158f-8089-431d-b866-dc334e8d4758' title: National FOIA Portal - JSON CFO Meeting API version: Versioning not supported servers: - url: https://api.foia.gov/api security: - APIKeyHeader: [] tags: - name: CFO Meeting paths: /node/cfo_meeting: get: summary: List CFO Meetings description: Endpoint for listing node--cfo_meeting resource type. The ID returned can be used to get details for the CFO Meeting. parameters: - name: page[limit] in: query required: false description: Limiting the result set to 10 reports is necessary due to the high number of Annual Reports.
Learn more about Pagination in the Drupal documentation.
schema: type: number - name: page[offset] in: query required: false description:The offset is the result you want to start with. An offset of 3 and a page[limit] of 10 will list ten items starting from item 3. Each JSON response from the API will have built in pagination under links.
Learn more about Pagination in the Drupal documentation.
schema: type: string - name: sort in: query required: false description:You can sort results in alphabetical order by multiple fields such as title. You can also sort by other useful fields such as the author name uid.name.
field_meeting_date, changed, created, moderation_stateLearn more about sorting in the Drupal documentation.
schema: type: array - name: sort[sort-created][direction] in: query required: false description: You can change the sorting direction by using eitherDESC and ASC.
schema:
type: string
- name: include
in: query
required: false
description: Embed related entities in the JSON response under relationships. Learn more in the documentation.
node_type, revision_uid, uid, menu_link, field_meeting_agenda, field_meeting_documents, field_meeting_materials
schema:
type: string
tags:
- CFO Meeting
responses:
'200':
description: successful operation
content:
application/vnd.api+json:
schema:
title: node:cfo_meeting Schema
description: Meetings for the Chief FOIA Officers Council. Contains the date, body, heading, agenda, and links to meeting related documents and information.
type: object
required:
- data
properties:
data:
type: array
items:
$ref: '#/components/schemas/node--cfo_meeting/properties/data'
meta:
description: Non-standard meta-information that can not be represented as an attribute or relationship.
type: object
additionalProperties: true
links:
type: object
additionalProperties:
description: 'A link **MUST** be represented as either: a string containing the link''s URL or a link object . '
type: object
required:
- href
properties:
href:
description: 'A string containing the link''s URL . '
type: string
format: uri - reference
meta:
description: Non-standard meta-information that can not be represented as an attribute or relationship.
type: object
additionalProperties: true
jsonapi:
description: An object describing the server's implementation
type: object
properties:
version:
type: string
meta:
description: Non-standard meta-information that can not be represented as an attribute or relationship.
type: object
additionalProperties: true
additionalProperties: false
additionalProperties: true
'403':
description: 'Forbidden: The api_key is missing'
operationId: getNodeCfoMeeting
x-operation-id-source: derived
/cfo_meeting/{entity}:
get:
summary: Get CFO Meeting
description: 'Individual endpoint for the node--cfo_meeting resource type. You can use the following entity ID as an example.
142af11a-14ae-4372-8eda-6aadcb3154a6'
parameters:
- name: entity
required: true
in: path
description: The uuid of the node cfo_meeting which can be found by using the List CFO Meetings above.
schema:
type: string
tags:
- CFO Meeting
responses:
'200':
description: successful operation
content:
application/vnd.api+json:
schema:
type: object
properties:
data:
description: An array of objects each containing \"type\" and \"id\" members for to-many relationships.
type: array
items:
description: The "type" and "id" to non-empty members.
type: object
required:
- type
- id
properties:
type:
title: Resource type name
type: string
enum:
- paragraph--link_or_file
id:
title: Resource ID
type: string
format: uuid
meta:
description: Non-standard meta-information that can not be represented as an attribute or relationship.
type: object
additionalProperties: true
properties: {}
additionalProperties: false
uniqueItems: true
'400':
description: Syntax error
'403':
description: 'Forbidden: The api_key is missing'
'404':
description: Not Found
operationId: getCfoMeetingByEntity
x-operation-id-source: derived
/cfo_meeting/{entity}/field_meeting_agenda:
get:
summary: Get CFO Meeting Agenda Item
description: Endpoint for the paragraph--agenda_item resource type through the field_meeting_agenda relationship.
parameters:
- name: entity
required: true
in: path
description: The uuid of the node cfo_meeting
schema:
type: string
tags:
- CFO Meeting
responses:
'200':
description: Successful Operation
content:
application/vnd.api+json:
schema:
title: paragraph:agenda_item Schema
description: Describes the payload for 'paragraph' entities of the 'agenda_item' bundle.
type: object
required:
- data
properties:
data:
type: array
items:
$ref: '#/components/schemas/paragraph--agenda_item/properties/data'
meta:
description: Non-standard meta-information that can not be represented as an attribute or relationship.
type: object
additionalProperties: true
links:
type: object
additionalProperties:
description: 'A link **MUST** be represented as either: a string containing the link''s URL or a link object . '
type: object
required:
- href
properties:
href:
description: 'A string containing the link''s URL . '
type: string
format: uri - reference
meta:
description: Non-standard meta-information that can not be represented as an attribute or relationship.
type: object
additionalProperties: true
jsonapi:
description: An object describing the server's implementation
type: object
properties:
version:
type: string
meta:
description: Non-standard meta-information that can not be represented as an attribute or relationship.
type: object
additionalProperties: true
additionalProperties: false
additionalProperties: true
'400':
description: Syntax error
'403':
description: 'Forbidden: The api_key is missing'
'404':
description: Not Found
operationId: getCfoMeetingByEntityFieldMeetingAgenda
x-operation-id-source: derived
/cfo_meeting/{entity}/field_meeting_documents:
get:
summary: Get CFO Meeting Documents
description: Endpoint for the paragraph--link_or_file resource type through the field_meeting_documents resource object.
parameters:
- name: entity
required: true
in: path
description: The uuid of the node cfo_meeting.
schema:
type: string
tags:
- CFO Meeting
responses:
'200':
description: Successful Operation
content:
application/vnd.api+json:
schema:
title: paragraph:link_or_file Schema
description: Describes the payload for 'paragraph' entities of the 'link_or_file' bundle.
type: object
required:
- data
properties:
data:
type: array
items:
$ref: '#/components/schemas/paragraph--link_or_file/properties/data'
meta:
description: Non-standard meta-information that can not be represented as an attribute or relationship.
type: object
additionalProperties: true
links:
type: object
additionalProperties:
description: 'A link **MUST** be represented as either: a string containing the link''s URL or a link object . '
type: object
required:
- href
properties:
href:
description: 'A string containing the link''s URL . '
type: string
format: uri - reference
meta:
description: Non-standard meta-information that can not be represented as an attribute or relationship.
type: object
additionalProperties: true
jsonapi:
description: An object describing the server's implementation
type: object
properties:
version:
type: string
meta:
description: Non-standard meta-information that can not be represented as an attribute or relationship.
type: object
additionalProperties: true
additionalProperties: false
additionalProperties: true
'400':
description: Syntax error
'403':
description: 'Forbidden: The api_key is missing'
'404':
description: Not Found
operationId: getCfoMeetingByEntityFieldMeetingDocuments
x-operation-id-source: derived
/cfo_meeting/{entity}/field_meeting_materials:
get:
summary: Get CFO Meeting Materials
description: Endpoint for the paragraph--link_or_file resource type through the field_meeting_materials relationship.
parameters:
- name: entity
required: true
in: path
description: The uuid of the node cfo_meeting
schema:
type: string
tags:
- CFO Meeting
responses:
'200':
description: Successful Operation
content:
application/vnd.api+json:
schema:
title: paragraph:link_or_file Schema
description: Describes the payload for 'paragraph' entities of the 'link_or_file' bundle.
type: object
required:
- data
properties:
data:
type: array
items:
$ref: '#/components/schemas/paragraph--link_or_file/properties/data'
meta:
description: Non-standard meta-information that can not be represented as an attribute or relationship.
type: object
additionalProperties: true
links:
type: object
additionalProperties:
description: 'A link **MUST** be represented as either: a string containing the link''s URL or a link object . '
type: object
required:
- href
properties:
href:
description: 'A string containing the link''s URL . '
type: string
format: uri - reference
meta:
description: Non-standard meta-information that can not be represented as an attribute or relationship.
type: object
additionalProperties: true
jsonapi:
description: An object describing the server's implementation
type: object
properties:
version:
type: string
meta:
description: Non-standard meta-information that can not be represented as an attribute or relationship.
type: object
additionalProperties: true
additionalProperties: false
additionalProperties: true
'400':
description: Syntax error
'403':
description: 'Forbidden: The api_key is missing'
'404':
description: Not Found
operationId: getCfoMeetingByEntityFieldMeetingMaterials
x-operation-id-source: derived
components:
schemas:
paragraph--agenda_item:
title: paragraph:agenda_item Schema
description: Describes the payload for 'paragraph' entities of the 'agenda_item' bundle.
type: object
required:
- data
properties:
data:
description: \"Resource objects\" appear in a JSON:API document to represent resources.
type: object
required:
- type
- id
properties:
type:
type: string
title: type
description: Resource type
enum:
- paragraph--agenda_item
id:
type: string
title: Resource ID
format: uuid
maxLength: 128
attributes:
description: Entity attributes
type: object
additionalProperties: false
properties:
drupal_internal__id:
type: integer
title: ID
drupal_internal__revision_id:
type: integer
title: Revision ID
langcode:
type: object
properties:
value:
type: string
title: Language code
language:
type: language_reference
title: Language object
description: The referenced language
required:
- value
title: Language code
description: The paragraphs entity language code.
status:
type: boolean
title: Published
default: true
created:
type: number
title: Authored on
format: utc-millisec
description: The time that the Paragraph was created.
parent_id:
type: string
title: Parent ID
maxLength: 255
description: The ID of the parent entity of which this entity is referenced.
parent_type:
type: string
title: Parent type
maxLength: 32
description: The entity parent type to which this entity is referenced.
parent_field_name:
type: string
title: Parent field name
maxLength: 32
description: The entity parent field name to which this entity is referenced.
behavior_settings:
type: string
title: Behavior settings
description: The behavior plugin settings
default: a:0:{}
default_langcode:
type: boolean
title: Default translation
description: A flag indicating whether this is the default translation.
default: true
revision_default:
type: boolean
title: Default revision
description: A flag indicating whether this was a default revision when it was saved.
revision_translation_affected:
type: boolean
title: Revision translation affected
description: Indicates if the last edit of a translation belongs to current revision.
field_agenda_item_description:
type: string
title: Description
field_agenda_item_time:
type: integer
title: Time
field_agenda_item_title:
type: string
title: Title
maxLength: 255
required:
- revision_translation_affected
relationships:
description: Entity relationships
type: object
additionalProperties: false
properties:
paragraph_type:
type: object
properties:
data:
type: object
required:
- type
- id
properties:
type:
type: string
title: Referenced resource
enum:
- paragraphs_type--paragraphs_type
id:
type: string
title: Resource ID
format: uuid
maxLength: 128
title: Paragraph type
links:
type: object
additionalProperties:
description: 'A link **MUST** be represented as either: a string containing the link''s URL or a link object . '
type: object
required:
- href
properties:
href:
description: 'A string containing the link''s URL . '
type: string
format: uri - reference
meta:
description: Non-standard meta-information that can not be represented as an attribute or relationship.
type: object
additionalProperties: true
meta:
description: Non-standard meta-information that can not be represented as an attribute or relationship.
type: object
additionalProperties: true
additionalProperties: false
meta:
description: Non-standard meta-information that can not be represented as an attribute or relationship.
type: object
additionalProperties: true
links:
type: object
additionalProperties:
description: 'A link **MUST** be represented as either: a string containing the link''s URL or a link object . '
type: object
required:
- href
properties:
href:
description: 'A string containing the link''s URL . '
type: string
format: uri - reference
meta:
description: Non-standard meta-information that can not be represented as an attribute or relationship.
type: object
additionalProperties: true
jsonapi:
description: An object describing the server's implementation
type: object
properties:
version:
type: string
meta:
description: Non-standard meta-information that can not be represented as an attribute or relationship.
type: object
additionalProperties: true
additionalProperties: false
additionalProperties: true
paragraph--link_or_file:
title: paragraph:link_or_file Schema
description: Describes the payload for 'paragraph' entities of the 'link_or_file' bundle.
type: object
required:
- data
properties:
data:
description: \"Resource objects\" appear in a JSON:API document to represent resources.
type: object
required:
- type
- id
properties:
type:
type: string
title: type
description: Resource type
enum:
- paragraph--link_or_file
id:
type: string
title: Resource ID
format: uuid
maxLength: 128
attributes:
description: Entity attributes
type: object
additionalProperties: false
properties:
drupal_internal__id:
type: integer
title: ID
drupal_internal__revision_id:
type: integer
title: Revision ID
langcode:
type: object
properties:
value:
type: string
title: Language code
language:
type: language_reference
title: Language object
description: The referenced language
required:
- value
title: Language code
description: The paragraphs entity language code.
status:
type: boolean
title: Published
default: true
created:
type: number
title: Authored on
format: utc-millisec
description: The time that the Paragraph was created.
parent_id:
type: string
title: Parent ID
maxLength: 255
description: The ID of the parent entity of which this entity is referenced.
parent_type:
type: string
title: Parent type
maxLength: 32
description: The entity parent type to which this entity is referenced.
parent_field_name:
type: string
title: Parent field name
maxLength: 32
description: The entity parent field name to which this entity is referenced.
behavior_settings:
type: string
title: Behavior settings
description: The behavior plugin settings
default: a:0:{}
default_langcode:
type: boolean
title: Default translation
description: A flag indicating whether this is the default translation.
default: true
revision_default:
type: boolean
title: Default revision
description: A flag indicating whether this was a default revision when it was saved.
revision_translation_affected:
type: boolean
title: Revision translation affected
description: Indicates if the last edit of a translation belongs to current revision.
field_link_label:
type: string
title: Label
maxLength: 100
description: 'Using the fields below, enter either:
a link/URL to an existing piece of content or other external webpage.
upload a file using the \"Choose File\" browser
'
field_link_link:
type: object
properties:
uri:
type: string
title: URI
title:
type: string
title: Link text
title: Link
required:
- revision_translation_affected
relationships:
description: Entity relationships
type: object
additionalProperties: false
properties:
paragraph_type:
type: object
properties:
data:
type: object
required:
- type
- id
properties:
type:
type: string
title: Referenced resource
enum:
- paragraphs_type--paragraphs_type
id:
type: string
title: Resource ID
format: uuid
maxLength: 128
title: Paragraph type
field_link_file:
type: object
properties:
data:
type: object
required:
- type
- id
properties:
type:
type: string
title: Referenced resource
id:
type: string
title: Resource ID
format: uuid
maxLength: 128
title: File
links:
type: object
additionalProperties:
description: 'A link **MUST** be represented as either: a string containing the link''s URL or a link object . '
type: object
required:
- href
properties:
href:
description: 'A string containing the link''s URL . '
type: string
format: uri - reference
meta:
description: Non-standard meta-information that can not be represented as an attribute or relationship.
type: object
additionalProperties: true
meta:
description: Non-standard meta-information that can not be represented as an attribute or relationship.
type: object
additionalProperties: true
additionalProperties: false
meta:
description: Non-standard meta-information that can not be represented as an attribute or relationship.
type: object
additionalProperties: true
links:
type: object
additionalProperties:
description: 'A link **MUST** be represented as either: a string containing the link''s URL or a link object . '
type: object
required:
- href
properties:
href:
description: 'A string containing the link''s URL . '
type: string
format: uri - reference
meta:
description: Non-standard meta-information that can not be represented as an attribute or relationship.
type: object
additionalProperties: true
jsonapi:
description: An object describing the server's implementation
type: object
properties:
version:
type: string
meta:
description: Non-standard meta-information that can not be represented as an attribute or relationship.
type: object
additionalProperties: true
additionalProperties: false
additionalProperties: true
node--cfo_meeting:
title: node:cfo_meeting Schema
description: Meetings for the Chief FOIA Officers Council. Contains the date, body, heading, agenda, and links to meeting related documents and information.
type: object
required:
- data
properties:
data:
description: \"Resource objects\" appear in a JSON:API document to represent resources.
type: object
required:
- type
- id
properties:
type:
type: string
title: type
description: Resource type
enum:
- node--cfo_meeting
id:
type: string
title: Resource ID
format: uuid
maxLength: 128
attributes:
description: Entity attributes
type: object
additionalProperties: false
properties:
drupal_internal__nid:
type: integer
title: ID
drupal_internal__vid:
type: integer
title: Revision ID
langcode:
type: object
properties:
value:
type: string
title: Language code
language:
type: language_reference
title: Language object
description: The referenced language
required:
- value
title: Language
revision_timestamp:
type: number
title: Revision create time
format: utc-millisec
description: The time that the current revision was created.
revision_log:
type: string
title: Revision log message
description: Briefly describe the changes you have made.
default: ''
status:
type: boolean
title: Published
default: true
title:
type: string
title: Title
maxLength: 255
created:
type: number
title: Authored on
format: utc-millisec
description: The time that the node was created.
changed:
type: number
title: Changed
format: utc-millisec
description: The time that the node was last edited.
promote:
type: boolean
title: Promoted to front page
default: false
sticky:
type: boolean
title: Sticky at top of lists
default: false
default_langcode:
type: boolean
title: Default translation
description: A flag indicating whether this is the default translation.
default: true
revision_default:
type: boolean
title: Default revision
description: A flag indicating whether this was a default revision when it was saved.
revision_translation_affected:
type: boolean
title: Revision translation affected
description: Indicates if the last edit of a translation belongs to current revision.
moderation_state:
type: string
title: Moderation state
maxLength: 255
description: The moderation state of this piece of content.
scheduled_transition_date:
type: array
title: Scheduled transition date
items:
type: object
properties:
value:
type: string
title: Date value
format: date
required:
- value
scheduled_transition_state:
type: array
title: Scheduled transition state
items:
type: string
title: Text value
maxLength: 255
scheduled_publication:
type: object
properties:
value:
type: string
title: Date value
format: date
required:
- value
scheduled_moderation_state:
type: string
title: Text value
maxLength: 255
metatag:
type: object
title: Metatags (Hidden field for JSON support)
description: The meta tags for the entity.
path:
type: object
properties:
alias:
type: string
title: Path alias
pid:
type: integer
title: Path id
langcode:
type: string
title: Language Code
title: URL alias
body:
type: object
properties:
value:
type: string
title: Text
format:
type: string
title: Text format
summary:
type: string
title: Summary
required:
- value
title: Body
field_meeting_date:
type: object
properties:
value:
type: string
title: Date value
format: date
required:
- value
title: Meeting Date
description: Enter the required meeting date. This will control the sort order of all meetings on the council page.
field_meeting_heading:
type: object
properties:
value:
type: string
title: Text
format:
type: string
title: Text format
required:
- value
title: Heading
description: The heading will appear at the top of the agenda page for this meeting.
required:
- title
- revision_translation_affected
- metatag
- path
- field_meeting_date
relationships:
description: Entity relationships
type: object
additionalProperties: false
properties:
node_type:
type: object
properties:
data:
type: object
required:
- type
- id
properties:
type:
type: string
title: Referenced resource
enum:
- node_type--node_type
id:
type: string
title: Resource ID
format: uuid
maxLength: 128
title: Content type
revision_uid:
type: object
properties:
data:
type: object
required:
- type
- id
properties:
type:
type: string
title: Referenced resource
enum:
- user--user
id:
type: string
title: Resource ID
format: uuid
maxLength: 128
title: Revision user
uid:
type: object
properties:
data:
type: object
required:
- type
- id
properties:
type:
type: string
title: Referenced resource
enum:
- user--user
id:
type: string
title: Resource ID
format: uuid
maxLength: 128
title: Authored by
menu_link:
type: object
properties:
data:
type: object
required:
- type
- id
properties:
type:
type: string
title: Referenced resource
enum:
- menu_link_content--menu_link_content
id:
type: string
title: Resource ID
format: uuid
maxLength: 128
title: Menu link
field_meeting_agenda:
type: object
properties:
data:
type: array
items:
type: object
required:
- type
- id
properties:
type:
type: string
title: Referenced resource
enum:
- paragraph--agenda_item
id:
type: string
title: Resource ID
format: uuid
maxLength: 128
title: Agenda
field_meeting_documents:
type: object
properties:
data:
type: array
items:
type: object
required:
- type
- id
properties:
type:
type: string
title: Referenced resource
enum:
- paragraph--link_or_file
id:
type: string
title: Resource ID
format: uuid
maxLength: 128
title: Working Documents
field_meeting_materials:
type: object
properties:
data:
type: array
items:
type: object
required:
- type
- id
properties:
type:
type: string
title: Referenced resource
enum:
- paragraph--link_or_file
id:
type: string
title: Resource ID
format: uuid
maxLength: 128
title: Meeting Materials
links:
type: object
additionalProperties:
description: 'A link **MUST** be represented as either: a string containing the link''s URL or a link object . '
type: object
required:
- href
properties:
href:
description: 'A string containing the link''s URL . '
type: string
format: uri - reference
meta:
description: Non-standard meta-information that can not be represented as an attribute or relationship.
type: object
additionalProperties: true
meta:
description: Non-standard meta-information that can not be represented as an attribute or relationship.
type: object
additionalProperties: true
additionalProperties: false
meta:
description: Non-standard meta-information that can not be represented as an attribute or relationship.
type: object
additionalProperties: true
links:
type: object
additionalProperties:
description: 'A link **MUST** be represented as either: a string containing the link''s URL or a link object . '
type: object
required:
- href
properties:
href:
description: 'A string containing the link''s URL . '
type: string
format: uri - reference
meta:
description: Non-standard meta-information that can not be represented as an attribute or relationship.
type: object
additionalProperties: true
jsonapi:
description: An object describing the server's implementation
type: object
properties:
version:
type: string
meta:
description: Non-standard meta-information that can not be represented as an attribute or relationship.
type: object
additionalProperties: true
additionalProperties: false
additionalProperties: true
securitySchemes:
APIKeyHeader:
type: apiKey
in: header
name: X-API-Key