Falken
  1. NewsArticle
Falken
  • Athletes
    • Returns all athletes.
      GET
    • Creates a new athlete.
      POST
    • Returns a single athlete by ID.
      GET
    • Updates an existing athlete.
      PUT
    • Deletes an athlete.
      DELETE
  • FalkenAI
    • Detect the predominant language of the supplied text.
      POST
    • Perform sentiment analysis on the supplied text.
      POST
    • Extract key phrases from the supplied text.
      POST
    • Upload an image and receive a descriptive caption.
      POST
    • Chat with the OpenAI assistant.
      POST
    • Legacy text completion.
      POST
    • Generate embeddings for the given text.
      POST
    • Moderate content.
      POST
    • Generate image(s) from a text prompt.
      POST
    • Transcribe an audio file using Whisper.
      POST
    • Translate an audio file to English.
      POST
    • List available OpenAI models.
      GET
  • Me
    • Returns every active organization-role assignment for the signed-in user.
  • NewsArticle
    • Get all news articles for an organization.
      GET
    • Create a new news article.
      POST
    • Get a specific news article by ID.
      GET
    • Update an existing news article.
      PUT
    • Delete a news article.
      DELETE
    • Get a specific news article by slug.
      GET
    • Publish a news article.
      POST
    • Get trending news articles for an organization.
      GET
    • Track a view for a news article.
      POST
    • Upload a featured image for a news article.
      POST
  • NewsAuthor
    • Get all news authors for an organization.
    • Create a new news author for the current user.
    • Get a specific news author by ID.
    • Update an existing news author.
    • Delete a news author.
    • Get the author profile for the current user in this organization.
  • NewsCategory
    • Get all news categories for an organization.
    • Create a new news category.
    • Get a specific news category by ID.
    • Update an existing news category.
    • Delete a news category.
    • Get a specific news category by slug.
  • OrganizationAddresses
    • /api/organizations/{organizationId}/addresses
    • /api/organizations/{organizationId}/addresses
    • /api/organizations/{organizationId}/addresses/{id}
    • /api/organizations/{organizationId}/addresses/{id}
    • /api/organizations/{organizationId}/addresses/{id}
    • List all organization addresses globally.
    • List organization addresses filtered by Falken.Axios.Enums.AddressType.
  • OrganizationContacts
    • /api/organizations/{organizationId}/contacts
    • /api/organizations/{organizationId}/contacts
    • /api/organizations/{organizationId}/contacts/{id}
    • /api/organizations/{organizationId}/contacts/{id}
    • /api/organizations/{organizationId}/contacts/{id}
  • OrganizationLogos
    • Returns all logos for an organization (public).
    • Uploads a new logo (admin only).
    • Returns logos of a specific logoType for an organization (public).
    • Returns a single logo by its ID (public).
    • Delete a logo (admin only).
    • Permanently delete a logo and its blob (admin only).
  • OrganizationRosters
    • /api/organizations/{organizationId}/roster
    • /api/organizations/{organizationId}/roster
    • /api/organizations/{organizationId}/roster/{id}
    • /api/organizations/{organizationId}/roster/{id}
    • /api/organizations/{organizationId}/roster/{id}
    • /api/organizations/{organizationId}/roster/search
  • Organizations
    • Get all organizations (public endpoint).
    • Create a new organization (admin only).
    • Get all organizations for a specific organization type.
    • Get an organization by ID (public endpoint).
    • Update an organization (admin only).
    • Delete an organization (admin only).
  • OrganizationTeams
    • /api/organizations/{organizationId}/teams
    • /api/organizations/{organizationId}/teams
    • /api/organizations/{organizationId}/teams/{id}
    • /api/organizations/{organizationId}/teams/{id}
    • /api/organizations/{organizationId}/teams/{id}
    • /api/organizations/{organizationId}/teams/{teamId}/members
    • /api/organizations/{organizationId}/teams/{teamId}/members
    • /api/organizations/{organizationId}/teams/{teamId}/members/{memberId}
    • /api/organizations/{organizationId}/teams/{teamId}/members/{memberId}
    • /api/organizations/{organizationId}/teams/search
  • OrganizationTypes
    • Get all organization types (public endpoint).
    • Create a new organization type (admin only).
    • Get an organization type by ID (public endpoint).
    • Update an organization type (admin only).
    • Delete an organization type (admin only).
  • OrganizationUsers
    • Get all users and their roles for an organization.
    • Get roles for a specific user in an organization.
    • Assign a role to a user in an organization.
    • Remove a role from a user in an organization.
    • Get all available roles that can be assigned.
  • Password
    • Returns whether the authenticated user can change their password via the UI.
    • /api/user/password/change
  • ReservedTerm
    • Get all reserved terms.
    • Create a new reserved term.
    • Get reserved terms for a specific scope.
    • Get a specific reserved term by ID.
    • Update an existing reserved term.
    • Delete a reserved term.
    • Validate content against reserved terms.
  • SocialMediaProvider
    • Get all social media providers.
    • Create a new social media provider.
    • Get all active social media providers.
    • Get a specific social media provider by ID.
    • Update an existing social media provider.
    • Delete a social media provider.
  • UserAvatars
    • Upload an avatar image. Only jpg, png and webp are allowed.
    • Get all avatars for a user (self or admin only).
    • Upload an avatar image. Only jpg, png and webp are allowed.
    • Get all avatars for a user (self or admin only).
    • Delete an avatar (soft delete). Only the user or an admin may delete.
    • Delete an avatar (soft delete). Only the user or an admin may delete.
    • Permanently delete an avatar (admin only).
    • Permanently delete an avatar (admin only).
    • Mark an avatar as the current profile image (self or admin).
    • Mark an avatar as the current profile image (self or admin).
  • UserProfiles
    • Get all user profiles (admin only)
    • Create a profile (user or admin).
    • Get the current user's profile.
    • Update a profile. Users may update self; admins may update any.
    • Delete a profile (admin only).
  • VanityUrl
    • Checks whether the supplied vanity URL is valid.
  • AthleteProfileImage
    • Uploads a profile image for the specified athlete.
    • Gets all profile images for the specified athlete.
    • Gets a specific profile image by its ID.
    • Deletes a profile image.
    • Gets a profile image by athlete ID and image type.
  • AthleteSocialMediaProfiles
    • Gets all social media profiles for a specific athlete.
    • Creates a new social media profile for an athlete.
    • Gets a specific social media profile by ID.
    • Updates an existing social media profile.
    • Deletes a social media profile.
  • Competition
    • Gets all competitions.
    • Creates a new competition.
    • Gets a competition by its unique identifier.
    • Updates an existing competition.
    • Deletes a competition.
    • Gets competitions by league season ID.
  • Conference
    • Gets all conferences for a specific league.
    • Creates a new conference.
    • Gets all divisions for a specific conference.
    • Gets a conference by its unique identifier.
    • Updates an existing conference.
    • Deletes a conference.
  • Contacts
    • Imports a bulk list of contacts for an organization.
    • Gets all contacts for an organization.
    • Gets a single contact by ID.
    • Updates an existing contact.
    • Deletes a contact.
    • Creates a new contact for an organization.
  • CorporateSponsors
    • Gets all corporate sponsors for a specific campaign.
    • Gets a specific corporate sponsor by ID.
    • Updates a corporate sponsor.
    • Deletes a corporate sponsor.
  • Disciplines
    • Get all disciplines.
    • Create a new discipline.
    • Get a discipline by ID.
    • Update an existing discipline.
    • Delete a discipline.
  • Division
    • Gets all divisions for a specific conference.
    • Creates a new division.
    • Gets a division by its unique identifier.
    • Updates an existing division.
    • Deletes a division.
  • FundraisingCampaigns
    • Creates a new fundraising campaign.
    • Lists campaigns by scope for an organization.
    • Updates an existing fundraising campaign.
    • Deletes a fundraising campaign.
    • Gets a specific fundraising campaign by ID.
    • Adds a corporate sponsor to a campaign.
    • Gets campaign statistics including total raised and progress.
  • FundraisingContactDNC
    • Adds a contact to the Do Not Contact list. This endpoint can be called by users who want to opt out of fundraising communications.
    • Removes a contact from the Do Not Contact list. This endpoint allows users to opt back into fundraising communications.
    • Checks if an email is on the Do Not Contact list.
    • Gets all Do Not Contact records (Admin only).
  • FundraisingEmployerOrganizations
    • Gets all fundraising employer-organization relationships.
    • Creates a new fundraising employer-organization relationship.
    • Gets fundraising employer-organization relationships for a specific employer.
    • Gets fundraising employer-organization relationships for a specific organization.
    • Gets a specific fundraising employer-organization relationship by ID.
    • Updates an existing fundraising employer-organization relationship.
    • Deletes a fundraising employer-organization relationship.
  • FundraisingEmployers
    • Gets all fundraising employers.
    • Creates a new fundraising employer.
    • Gets a specific fundraising employer by ID.
    • Updates an existing fundraising employer.
    • Deletes a fundraising employer.
  • League
    • Gets all leagues.
    • Creates a new league.
    • Gets a league by its unique identifier.
    • Updates an existing league.
    • Deletes a league.
  • Range
    • Gets all ranges.
    • Creates a new range.
    • Gets a range by its unique identifier.
    • Updates an existing range.
    • Deletes a range.
    • Gets ranges by organization ID.
    • Updates a range's online status.
    • Gets all firing points for a range.
    • Creates a new firing point for a range.
    • Gets a firing point by its unique identifier.
    • Updates an existing firing point.
    • Deletes a firing point.
    • Updates a firing point's online status.
  • Rulebooks
    • Get all rulebooks.
    • Create a new rulebook.
    • Get a rulebook by ID.
    • Update an existing rulebook.
    • Delete a rulebook.
    • Get all versions of a rulebook.
    • Create a new version of a rulebook.
    • Publish a specific version of a rulebook.
  • RulebookVersions
    • Get a specific rulebook version by ID.
  • SanctioningBody
    • Create a new sanctioning body, optionally with a logo upload.
    • Get all sanctioning bodies.
    • Create a new sanctioning body.
    • Get all active sanctioning bodies.
    • Update an existing sanctioning body, optionally with a new logo.
    • Get a specific sanctioning body by ID.
    • Update an existing sanctioning body.
    • Delete a sanctioning body (soft delete - sets state to Deleted).
    • Upload and set the logo for an existing sanctioning body.
  • TargetScoring
    • Scores a paper target image using computer vision.
  1. NewsArticle

Create a new news article.

POST
https://api.falken.ltd/api/organizations/{organizationId}/news/articles
Last modified:2025-07-07 15:59:21
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.falken.ltd/api/organizations//news/articles' \
--header 'Content-Type: application/json' \
--data-raw '{
    "title": "string",
    "slug": "string",
    "excerpt": "string",
    "content": "string",
    "authorId": "ee6f7132-bd0a-4fcd-83b3-a8022377067b",
    "categoryId": "337f5e5d-288b-40d5-be14-901cc3acacc0",
    "audience": 0,
    "status": 0,
    "featuredImageUrl": "http://example.com",
    "publishAt": "2019-08-24T14:15:22Z",
    "archiveAt": "2019-08-24T14:15:22Z"
}'
Response Response Example
201 - Example 1
{
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "title": "string",
    "slug": "string",
    "excerpt": "string",
    "content": "string",
    "organizationId": "7bc05553-4b68-44e8-b7bc-37be63c6d9e9",
    "authorId": "ee6f7132-bd0a-4fcd-83b3-a8022377067b",
    "author": {
        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
        "displayName": "string",
        "bio": "string",
        "organizationId": "7bc05553-4b68-44e8-b7bc-37be63c6d9e9",
        "created": "2019-08-24T14:15:22Z",
        "updated": "2019-08-24T14:15:22Z",
        "auth0UserId": "string",
        "avatarUrl": "string",
        "email": "string"
    },
    "categoryId": "337f5e5d-288b-40d5-be14-901cc3acacc0",
    "category": {
        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
        "name": "string",
        "slug": "string",
        "description": "string",
        "organizationId": "7bc05553-4b68-44e8-b7bc-37be63c6d9e9",
        "displayOrder": 0,
        "created": "2019-08-24T14:15:22Z",
        "updated": "2019-08-24T14:15:22Z",
        "createdBy": "25a02396-1048-48f9-bf93-102d2fb7895e"
    },
    "audience": 0,
    "status": 0,
    "featuredImageUrl": "string",
    "publishAt": "2019-08-24T14:15:22Z",
    "archiveAt": "2019-08-24T14:15:22Z",
    "created": "2019-08-24T14:15:22Z",
    "updated": "2019-08-24T14:15:22Z",
    "viewCount": 0
}

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Path Params
organizationId
string <uuid>
required
Organization ID
Body Params application/json
title
string 
required
>= 0 characters<= 200 characters
slug
string 
required
>= 0 characters<= 200 characters
Match pattern:
^[a-z0-9-]+$
excerpt
string  | null 
optional
>= 0 characters<= 500 characters
content
string 
required
>= 1 characters
authorId
string <uuid>
required
categoryId
string <uuid> | null 
optional
audience
enum<integer> <int32>
required
Allowed values:
01
status
enum<integer> <int32>
required
Allowed values:
012
featuredImageUrl
string <uri> | null 
optional
>= 0 characters<= 500 characters
publishAt
string <date-time> | null 
optional
archiveAt
string <date-time> | null 
optional
Examples

Responses

🟢201Created
text/plain
Created
Body
id
string <uuid>
optional
title
string  | null 
optional
slug
string  | null 
optional
excerpt
string  | null 
optional
content
string  | null 
optional
organizationId
string <uuid>
optional
authorId
string <uuid>
optional
author
object (Falken.Axios.Responses.News.NewsAuthorResponse) 
optional
id
string <uuid>
optional
displayName
string  | null 
optional
bio
string  | null 
optional
organizationId
string <uuid>
optional
created
string <date-time>
optional
updated
string <date-time>
optional
auth0UserId
string  | null 
optional
avatarUrl
string  | null 
optional
email
string  | null 
optional
categoryId
string <uuid> | null 
optional
category
object (Falken.Axios.Responses.News.NewsCategoryResponse) 
optional
id
string <uuid>
optional
name
string  | null 
optional
slug
string  | null 
optional
description
string  | null 
optional
organizationId
string <uuid>
optional
displayOrder
integer <int32>
optional
created
string <date-time>
optional
updated
string <date-time>
optional
createdBy
string <uuid>
optional
audience
enum<integer> <int32>
optional
Allowed values:
01
status
enum<integer> <int32>
optional
Allowed values:
012
featuredImageUrl
string  | null 
optional
publishAt
string <date-time> | null 
optional
archiveAt
string <date-time> | null 
optional
created
string <date-time>
optional
updated
string <date-time>
optional
viewCount
integer <int32>
optional
🟠400Bad Request
🟠401Unauthorized
🟠403Forbidden
🟠409409
Modified at 2025-07-07 15:59:21
Previous
Get all news articles for an organization.
Next
Get a specific news article by ID.
Built with