V1 Users Extended by Roles returns 404 when making requests with certain base_role_rids

Gerald Truong
Gerald Truong
Second Anniversary Name Dropper Participant Facilitator 1
in Education Management APIs

Hello,

When calling /v1/users/extended?base_role_ids=14,15,17,562 we are getting a 404 even though calling /v1/users/extended?base_role_ids=14,15 works.

Is this to be expected?

Comments

  • Brian Gray
    Brian Gray Community All-Star
    Eighth Anniversary Kudos 5 First Reply bbcon 2025 Attendee Badge

    @Gerald Truong - I tested that combination of base role IDs in the Developer's Portal and in one of my programs (VB.net using SKYLib.Net). It worked as expected for me.

  • Gerald Truong
    Gerald Truong
    Second Anniversary Name Dropper Participant Facilitator 1

    Good morning @Brian Gray, then I am stumped :) not sure why we are getting a 404. Any chance you could send me your version of the request URL? Maybe we malformed ours…

  • Brian Gray
    Brian Gray Community All-Star
    Eighth Anniversary Kudos 5 First Reply bbcon 2025 Attendee Badge

    @Gerald Truong - The complete URL is

    Have you tried it in the Developer's Portal? It shows you the URL for the call and the returned data (or error message).

    756d82d81bf4cffece119f7958d53cc5-huge-ug


  • Gerald Truong
    Gerald Truong
    Second Anniversary Name Dropper Participant Facilitator 1

    TY @Brian Gray! We are having issue testing within the developer portal. We get one of the following error:

    • “You don’t have access to any SKY API enabled Blackbaud products.”
    • { "statusCode": 401, "message": "The required Authorization header was missing or invalid, or the token has expired", "status": 401, "title": "The required Authorization header was missing or invalid, or the token has expired" }

    We have an OAuth client_id and 2 OAuth secrets but not sure how do they get applied to the authorization fields within the request form. Under headers we see Bb-Api-Subscription-Key and under Authorization we get 2 fields: Blackbaud OAuth 2.0 Service and Subscription key. How does one get a subscription key for the developer portal?

  • Brian Gray
    Brian Gray Community All-Star
    Eighth Anniversary Kudos 5 First Reply bbcon 2025 Attendee Badge

    @Gerald Truong - on the Developer's console page, near the top of the page there is a Try it button. (If there is a message next to it that says that you must sign in, do that - using an account that is authorized to use the API.)

    When you are signed in with a valid account, you don't need to set the fields labeled BB-Api-Subscription-Key, Authorization, or Subscription key. Don't change them.

    • Click the Try it button
    • Enter a base role ID in the appropriate field.
    • In section labeled Blackbaud OAuth 2.0 Service, select Authorization code.
    • A pop-up window will appear. Click Authorize. The pop-up will close. (If the pop-up does not appear, check your pop-up blocking settings.)
    • Scroll down and click the Send button.
    cf03bd1bd584161fc13df3891634cad0-huge-tr

    The pop-up authorization widow:

    02bfc4e4953b5b9678ca5692758af5ea-huge-tr

Categories